{% extends "base.html" %} {% load staticfiles %} {% block title %}Documentation - healthchecks.io{% endblock %} {% block content %}

Summary

Each check you create in My Checks page has an unique "ping" URL. Whenever you access this URL, the "Last Ping" value of corresponding check is updated.

When a certain amount of time passes since last received ping, the check is considered "late", and Health Checks sends an email alert. It is all very simple, really.

Executing a Ping

At the end of your batch job, add a bit of code to request one of your ping URLs.

The response will have status code "200 OK" and response body will be a short and simple string "OK".

In bash scripts, you can use wget or curl to run the requests:

curl http://healthchecks.io/ping/uuid-goes-here

When Alerts Are Sent

Each check has a configurable "Frequency" parameter, with default value of one day.

When time since last ping exceeds the configured amount, the check is considered late. When a check is 1 hour late, Health Checks sends you an email alert.

{% endblock %}