Heartbeat monitors

A heartbeat monitor expects your job to call a unique URL on a schedule. If the call does not arrive on time, the monitor goes down.

Create the monitor

Add monitor → Heartbeat. Set the expected interval (for example 24 hours) and a grace period (for example 30 minutes). Copy the ping URL.

Ping from your job

0 3 * * * /usr/local/bin/backup.sh && curl -fsS -m 10 https://hb.uptimepush.com/p/YOUR-TOKEN

Because of the &&, the ping only happens when the script succeeds.

Report failures explicitly

curl -fsS https://hb.uptimepush.com/p/YOUR-TOKEN/fail

Send a status message

curl -fsS "https://hb.uptimepush.com/p/YOUR-TOKEN?msg=backup+size+2.1GB"

Kubernetes and GitHub Actions

Add the curl command as the last step of the job. For GitHub Actions, store the token as a secret.