Heartbeat (cron)
Copies this page as Markdown with context, so an AI can walk you through your case step by step.
For jobs that expose no port: your script reports that it ran, and if it does not report on time, we alert you.
How it works
- Create a Heartbeat monitor with the expected interval (for example, 24 hours for a nightly backup).
- Copy the unique URL shown in the monitor detail.
- Send a request to that URL at the end of your job, only if it succeeded.
If we do not receive the heartbeat within the interval plus a 60-second grace period, the monitor goes down and an incident opens.
Examples
cron
0 3 * * * /usr/local/bin/backup.sh && curl -fsS -m 10 https://ganyant.com/api/heartbeat/YOUR_TOKENsystemd timer (ExecStartPost)
ExecStartPost=/usr/bin/curl -fsS -m 10 https://ganyant.com/api/heartbeat/YOUR_TOKENPowerShell
Invoke-RestMethod -Uri "https://ganyant.com/api/heartbeat/YOUR_TOKEN" -Method Post -TimeoutSec 10Node.js
await fetch('https://ganyant.com/api/heartbeat/YOUR_TOKEN', { method: 'POST' });Details
GET,POSTandHEADare accepted.- The response is
200with{"ok":true}, or404if the token does not exist. - The token is secret: anyone who has it can mark the job as done.