Health & Heartbeat

ZenEdge monitors adapter health by periodically calling the /ping endpoint.

/ping Semantics

• Returns 200 with {"status": "ok"} when healthy
• Returns 503 or times out when unhealthy
• Response time is tracked for latency monitoring

Polling Cadence

Criticality	Default Interval	Timeout
CRITICAL	30 seconds	10 seconds
STANDARD	60 seconds	15 seconds
OPTIONAL	120 seconds	30 seconds

Failure Detection

Consecutive ping failures trigger escalating responses:

Failures	Action
1-2	Logged, no alert
3-5	Warning in admin dashboard
5+	Alert triggered, device marked unhealthy
10+	Device marked as offline

Health Status in Admin Dashboard

Adapters show health status in the admin list:

• Active (green) — Recent ping successful
• Warning (yellow) — Recent failures detected
• Error (red) — Device unreachable
• Disabled (grey) — Manually disabled by admin

Next Steps

• HTML Embed Builder — Guest-facing UI
• Webhook Registration — Push events