Create heartbeat monitor
Goal: Create a Heartbeat monitor and get the ping address that you insert into your cron job.
Step 1: Open the monitor creation form
- In the ePulz.io overview, click + Add monitor
- Select the type Heartbeat (cron)
Step 2: Name the monitor
Use a descriptive name that reminds you what you are monitoring. Examples:
Nightly DB backupCRM sync (hourly)Weekly invoicingOld login cleanup
Step 3: Set the interval
Interval in minutes - how often the Heartbeat should arrive:
- 5 = every 5 minutes (short jobs, service check)
- 60 = every hour
- 1440 = daily (24 × 60)
- 10080 = weekly (7 × 24 × 60)
Step 4: Set the grace window
The grace period is the time after the expected deadline during which we still wait. Cron jobs can drift slightly (network time, delays, or the job takes longer than usual).
Recommendations:
- Short cron (5-60 min): grace 2-10 minutes
- Hourly cron: grace 10-15 minutes
- Daily cron: grace 30-60 minutes
- Weekly cron: grace 6 hours or more
Step 5: Notifications
Turn on which channels should receive a notification when a Heartbeat is missed:
- Telegram (requires a connected bot)
- Webhook (Slack, Discord, custom address)
Step 6: Save and get the address
Click Create monitor. The monitor detail appears with your unique Heartbeat address:
https://epulz.io/heartbeat/Qs78OPNIIsCF_-Vj
You add this address to your cron script or job. From now on, ePulz.io will expect a ping every [interval] minutes.
Monitor status
After creation, the monitor is in the Pending state (waiting for the first Heartbeat). After the first successful ping it switches to OK. If the Heartbeat does not arrive within the expected window, it switches to Down and sends a notification.
Next step:
Add the Heartbeat address to your cron job (examples for bash, Python, Node.js).
Adding to a cron job →