Heartbeats allow you to monitor that scheduled jobs, background workers, and recurring processes are running on time. Vibe OnCall expects a ping from your job at a defined interval — if no ping arrives within the expected window, an alert is automatically created and routed through your notification rules.

How Heartbeats Work

1. Navigate to Oncall → Heartbeats.
2. Create a heartbeat, specifying a name, expected ping interval, and optionally an associated team.
3. Copy the unique ping URL generated for your heartbeat.
4. Add a call to the ping URL at the end of each successful execution of your job.
5. If a ping does not arrive within the expected window, Vibe OnCall creates an alert and pages your on-call team according to your configured notification rules.
6. When a ping arrives after an alert was fired, the alert is automatically resolved — no manual action is required.

Common Use Cases

• Cron jobs and scheduled tasks
• Background workers and queue consumers
• Data pipelines and ETL jobs
• Any process that should run on a predictable cadence

Ping Endpoint

POST <https://events.vibraniumlabs.ai/heartbeat/ping/{shortId}>

Replace {shortId} with the unique identifier shown in your heartbeat's detail page (e.g., VP-HB-XXXX).