Heartbeat Monitor

Used to monitor periodically executing processes such as cron jobs and batch processes. Determines liveness based on whether periodic pings arrive at a Manako-issued endpoint.

How It Works

1. Manako issues an endpoint URL for the Heartbeat monitor
2. The monitored job sends an HTTP request (ping) to that URL upon completion
3. If no ping arrives within the configured grace period, a failure is detected

Configuration

Field	Description	Required	Default
Grace Period	Time to wait before marking as down when no ping is received	No	300 seconds (5 minutes)

The grace period can be set between 60 seconds and 86,400 seconds (24 hours). We recommend setting it slightly longer than the monitoring interval.

Setup Examples

curl

# Send a ping at the end of the job
curl -s https://hb.manako.dev/ping/{token}

crontab

# Hourly batch + Heartbeat ping
0 * * * * /path/to/job.sh && curl -s https://hb.manako.dev/ping/{token}

Docker

# Heartbeat ping via Dockerfile HEALTHCHECK
HEALTHCHECK --interval=5m CMD curl -sf https://hb.manako.dev/ping/{token} || exit 1

Tip

Chaining commands with && ensures the ping is only sent when the job succeeds. If the job fails, no ping is sent, and after the grace period expires, a failure is detected.

Incident Detection

A failure is detected when no ping is received within the configured grace period. Receiving a ping automatically triggers recovery.