Simple and Effective Cron Job Monitoring

We notify you when your nightly backups, weekly reports, cron jobs and scheduled tasks don't run on time.

For each of your tasks, Healthchecks.io provides a unique URL similar to this one:

https://hc-ping.com/eb095278-f28d-448d-87fb-7b75c171a6aa

Make an HTTP request to the provided URL each time your cron job completes. When Healthchecks.io does not receive a ping at the expected time, it sends you an alert. You can monitor any service that can make an HTTP request or send an email.

# m h dom mon dow command
  8 6 *   *   *   /home/user/backup.sh && curl -fsS -m 10 --retry 5 -o /dev/null https://hc-ping.com/eb095278-f28d-448d-87fb-7b75c171a6aa
# using curl (10 second timeout, retry up to 5 times):
curl -m 10 --retry 5 https://hc-ping.com/eb095278-f28d-448d-87fb-7b75c171a6aa
# using wget (10 second timeout, retry up to 5 times):
wget https://hc-ping.com/eb095278-f28d-448d-87fb-7b75c171a6aa -T 10 -t 5 -O /dev/null
# Using Python 3 standard library:
import socket
import urllib.request

try:
    urllib.request.urlopen("https://hc-ping.com/eb095278-f28d-448d-87fb-7b75c171a6aa", timeout=10)
except socket.error as e:
    # Log ping failure here...
    print("Ping failed: %s" % e)
# Using the requests library:
import requests

try:
    requests.get("https://hc-ping.com/eb095278-f28d-448d-87fb-7b75c171a6aa", timeout=10)
except requests.RequestException as e:
    # Log ping failure here...
    print("Ping failed: %s" % e)
require 'net/http'
require 'uri'

Net::HTTP.get(URI.parse('https://hc-ping.com/eb095278-f28d-448d-87fb-7b75c171a6aa'))
var https = require('https');
https.get('https://hc-ping.com/eb095278-f28d-448d-87fb-7b75c171a6aa').on('error', (err) => {
    console.log('Ping failed: ' + err)
});
package main

import "fmt"
import "net/http"
import "time"

func main() {
    var client = &http.Client{
        Timeout: 10 * time.Second,
    }

    _, err := client.Head("https://hc-ping.com/eb095278-f28d-448d-87fb-7b75c171a6aa")
    if err != nil {
        fmt.Printf("%s", err)
    }
}
file_get_contents('https://hc-ping.com/eb095278-f28d-448d-87fb-7b75c171a6aa');
using (var client = new System.Net.WebClient())
{
       client.DownloadString("https://hc-ping.com/eb095278-f28d-448d-87fb-7b75c171a6aa");
}
// the server returns appropriate CORS headers so cross-domain AJAX requests work:
var xhr = new XMLHttpRequest();
xhr.open('GET', 'https://hc-ping.com/eb095278-f28d-448d-87fb-7b75c171a6aa', true);
xhr.send(null);
# inside a PowerShell script:
Invoke-RestMethod https://hc-ping.com/eb095278-f28d-448d-87fb-7b75c171a6aa
# Without an underlying script, passing the command to PowerShell directly:
powershell.exe -command &{Invoke-RestMethod https://hc-ping.com/eb095278-f28d-448d-87fb-7b75c171a6aa}

As an alternative to HTTP requests, you can also report "liveness" by sending email messages.

You can instruct Healthchecks.io to look for a particular keyword in the subject line. This is handy when your backup software sends an email after every run, and uses a different subject line depending on success or failure.

Join 10,000+ developers and teams that use Healthchecks.io
to get immediately alerted when something breaks.

Start Monitoring

Monitor 20 cron jobs for free, no credit card required.

A quick peek of what's inside:

My Checks page

Live-updating Dashboard

A list of your checks, one for each Cron job, daemon or scheduled task you want to monitor.

Give names and assign tags to your checks to easily recognize them later.

Tap on the integration icons to toggle them on and off.

Adjust Period and Grace time to match the periodicity and duration of your tasks.

Period/Grace Time dialog

Simple Configuration

Each check has configurable Period and Grace Time parameters. Depending on these parameters and time since the last ping, the check is in one of the following states:
New. A check that has been created, but has not received any pings yet.
Up. The time since the last ping has not exceeded Period.
Late. The time since the last ping has exceeded Period, but has not yet exceeded Period + Grace.
Down. The time since the last ping has exceeded Period + Grace. When a check goes from "Late" to "Down", Healthchecks.io sends you a notification.
Cron dialog

Cron Expression Support

Alternatively, you can define the expected ping dates and times using a cron expression. See Cron Syntax Cheatsheet for the supported syntax features.

Grace Time specifies how "late" a ping can be before you are alerted. You should set it to be a little above the expected duration of your cron job.

Details Page

Details and Event Log

You can add a longer, free-form description to each check. Leave notes and pointers for yourself and your team.

You can also see the log of received pings and sent "Down" notifications.

Details Page

Public Status Badges

Healthchecks.io provides status badges for each of the tags you have used. Additionally, the "Healthchecks.io" badge shows the overall status of all checks in your account.

The badges have public, but hard-to-guess URLs. You can use them in your READMEs, dashboards, or status pages.

Integrations
Set up multiple ways to get notified:

Email
 

Webhooks
 

Discord
Chat

LINE Notify
Chat

Matrix
Chat

Mattermost
Chat

Microsoft Teams
Chat

OpsGenie
Incident Management

PagerTree
Incident Management

Phone Call
 

Pushbullet
Push Notifications

SMS
 

Spike.sh icon

Spike.sh
Incident Management

Trello
Project Management

VictorOps
Incident Management

WhatsApp
Chat

Zulip
Chat

Healthchecks.io

What Can I Monitor With Healthchecks.io?

Cron Jobs

Healthchecks.io monitoring is a perfect fit for cron jobs and cron-like systems (systemd timers, Jenkins build jobs, Windows Scheduled Tasks, wp-cron, uwsgi cron-like interface, Heroku Scheduler, ...). A failed cron job often has no immediate visible consequences and can go unnoticed for a long time.

Specific examples:

  • Filesystem backups
  • Database backups
  • Daily, weekly, monthly report emails
  • SSL renewals
  • Business data import and sync
  • Antivirus scans
  • Dynamic DNS updates

Processes, Services, Servers

You can use Healthchecks.io for lightweight server monitoring: ensuring a particular system service or the whole server is alive and healthy. Write a shell script that checks for a specific condition, and pings Healthchecks.io if successful. Run the shell script regularly.

Specific examples:

  • Check a specific docker container is running
  • Check a specific application process is running
  • Check database replication lag
  • Check system resources: free disk, free RAM, ...
  • Send simple, unconditional "I'm alive" messages from your server (or your NAS, router, Raspberry Pi, ...)

“Healthchecks.io has been extremely reliable and useful for the many years we've been using it. The system is very easy to use and well designed - the UI is clear and works the way you'd expect. The API is really handy too.”

“Healthchecks.io is an absolute lifesaver. I'm using it to monitor an IoT gateway, and once, thanks to the quick heads-up from Healthchecks, was able to save the device from being fried after it had been accidentally placed on top of a hot router while cleaning!”

Joona Heikkilä,
maker

“Healthchecks.io is a great service. Simple, effective, highly reliable. It's caught issues on multiple occasions so it makes me look good which is always nice.”

“Healthchecks.io is by far the most enjoyable, and simplest external monitoring tool we've ever used. It has never failed to perform its job even once, and has helped us detect errors in background tasks before they ever rise to a user-facing problem.”

Kevin Baragona,
cofounder of DeepAI