Healthchecks
Healthchecks overview
Inbound heartbeat pings for cron jobs, workers, and scheduled tasks.
Healthchecks flip the model: your job calls statusloop on a schedule. If pings stop, statusloop opens an incident and sends alerts.
UI: Sidebar → Healthchecks (/healthchecks)
How it works
- Create a healthcheck and copy the ping URL.
- Call that URL from your cron job, worker, or CI step when the job succeeds.
- statusloop expects the next ping within your period + grace period.
- If the deadline passes, status goes down and alerts fire.
Schedule modes
| Mode | Behavior |
|---|---|
simple (default) | Next expected ping = lastPingAt + interval |
cron | Next expected time from a cron expression (UTC, standard 5-field cron) |
Defaults when you create one
| Field | Default |
|---|---|
| Period | 1 day |
| Grace period | 10 minutes |
| Schedule mode | simple |
| Cron expression (cron mode) | 0 * * * * |
| Notifications | No notifications |
Period units: minutes, hours, or days (1–99,999). Grace period: minutes or hours only.
Status values
pending → up → late (still treated as up in UI) → down
Initial status on create: pending.
List filters
All, Up, Down, Waiting.
Detail tabs
Overview (ping URL, chart, event log), Settings, Notifications, Danger zone.
Was this helpful?