Help & guidesHeartbeat (cron monitoring) › Create heartbeat monitor

Create heartbeat monitor

3 min read · Heartbeat (cron monitoring)

Goal: Create a Heartbeat monitor and get the ping address that you insert into your cron job.

Step 1: Open the monitor creation form

  1. In the ePulz.io overview, click + Add monitor
  2. Select the type Heartbeat (cron)
New monitor form - type selection, address and interval
New monitor form - you select the type, enter a name and an interval.

Step 2: Name the monitor

Use a descriptive name that reminds you what you are monitoring. Examples:

  • Nightly DB backup
  • CRM sync (hourly)
  • Weekly invoicing
  • Old 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:

  • Email
  • 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.

Tip: The address is secret - anyone who knows it can pretend your cron is running. Do not share it and do not put it in public repositories.

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 →
Was this guide helpful?