Un moniteur de tâche cron fonctionne à l’inverse d’une vérification de site web : c’est votre tâche qui appelle une URL à chaque exécution. Si l’appel n’arrive pas à temps, vous recevez une alerte. Utilisez-le pour les sauvegardes, les imports nocturnes, les workers de files d’attente et tout ce qui tourne sans que personne ne surveille.
Créer le moniteur de tâche cron
Ouvrez Monitors, choisissez le filtre Cron jobs, puis New cron job.Sous The job runs, choisissez On an interval ou On a cron schedule.Pour un planning cron, saisissez la Cron expression de votre crontab, par exemple 0 3 * * *, et le Time zone dans lequel tourne la crontab du serveur. Le formulaire affiche les prochaines exécutions au fil de la saisie, et l’heure d’été est prise en compte.Réglez le Grace period : le retard toléré pour le ping avant que nous déclenchions une alerte.Si vous le souhaitez, définissez un Maximum run time, pour être alerté quand une exécution dure trop longtemps.Cochez les canaux d’alerte et choisissez Create monitor. Copiez la Ping URL sur la page qui s’ouvre.
Appeler l’URL depuis votre tâche
La configuration la plus simple envoie un ping quand la tâche réussit :
0 3 * * * /usr/local/bin/backup.sh && curl -fsS -m 10 –retry 3 -o /dev/null https://app.uptimecheck.com/api/hb/your-token
Avec &&, le ping n’est envoyé que si la tâche réussit. Une requête GET, POST ou HEAD est acceptée.
Durée d’exécution, codes de sortie et sortie
Appelez l’URL de ping suivie de /start au démarrage de la tâche. Vous voyez la durée de chaque exécution, et la durée maximale d’exécution peut déclencher une alerte.Appelez-la avec /fail, ou avec le code de sortie, par exemple /1, pour indiquer comment l’exécution s’est terminée. /0 signifie succès.Envoyez la sortie de la tâche en POST : elle s’affiche avec les échecs et dans l’alerte. Nous en conservons 10 000 caractères, le début et la fin, et les requêtes de plus de 64 Ko sont refusées : envoyez donc la fin d’un long journal, comme ci-dessous.
0 3 * * * curl -fsS -m 10 –retry 3 -o /dev/null https://app.uptimecheck.com/api/hb/your-token/start; /usr/local/bin/backup.sh > /tmp/backup.log 2>&1; code=$?; tail -c 60000 /tmp/backup.log | curl -fsS -m 10 –retry 3 –data-binary @- -o /dev/null https://app.uptimecheck.com/api/hb/your-token/$code
La page de la tâche cron affiche les deux exemples avec votre propre URL de ping : copiez-les depuis cette page. Pour Laravel, Kubernetes, GitHub Actions, systemd et Windows, consultez les exemples de ping pour tâches cron. En savoir plus sur la surveillance des tâches cron, et sur comment surveiller des tâches cron avec des heartbeats.