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.

For organization and team navigation, see Global and team pages.

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).