Heartbeats
A heartbeat means "ping me every X minutes or raise an alert." Use it for cron jobs, scheduled tasks, or anything that should check in regularly — so you hear about it when it goes quiet.
How it works
- You create a heartbeat and tell Alga how often to expect a ping — for example, every 5 minutes, with a little extra grace time.
- Alga gives you a private ping address. Add it to your job so it pings Alga on every run.
- As long as pings keep arriving, everything shows as healthy.
- If Alga doesn't hear from the job in time, it raises an alert that flows through your normal routing and notifications.
- The next ping clears the alert automatically.
Creating a heartbeat
- Go to Heartbeats → New Heartbeat.
- Give it a name like "Nightly backup."
- Set how often it should ping and how much grace time to allow.
- Pick a severity for the alert it raises.
- Save and copy the ping token right away — it is shown once, so keep it secret like a password.
If you lose the token, come back and regenerate it to get a new one.
Tips
- Pick intervals that match your job's real schedule, plus a minute or two of grace for slow runs.
- Give each job its own heartbeat so you know exactly which one went quiet.
- You can pause a heartbeat without deleting it when a job is intentionally stopped.