Surveiller une tâche cron ou un script

Un moniteur heartbeat surveille une tâche cron, un script de sauvegarde ou une tâche planifiée en attendant qu'elle se manifeste — il s'adresse à toute personne devant savoir quand une tâche en arrière-plan s'arrête silencieusement.

Aperçu

• La plupart des moniteurs contactent activement quelque chose pour le vérifier ; un moniteur heartbeat fonctionne à l'inverse — votre tâche appelle InfraNest chaque fois qu'elle se termine.
• Si l'appel n'arrive pas à temps, InfraNest vous alerte.
• C'est le meilleur moyen de détecter une tâche qui s'arrête de fonctionner sans générer d'erreur évidente.

Configurer un moniteur

1. Allez dans Monitoring et sélectionnez Add a monitor.
2. Choisissez Heartbeat / Cron monitor comme type.
3. Donnez-lui un Monitor name que vous reconnaîtrez dans une alerte — « Sauvegarde nocturne de la base de données » est plus clair que « job 1 ».
4. Définissez l'Intervalle de vérification selon la fréquence à laquelle la tâche est censée s'exécuter.
5. Définissez un Délai de grâce (secondes) — temps supplémentaire toléré avant que la tâche ne soit considérée comme en retard. Une sauvegarde qui dure généralement quatre minutes mais parfois huit nécessite un délai de grâce nettement supérieur à ce dépassement.
6. Sélectionnez Créer le moniteur.

Vous ne saisissez pas d'URL pour ce type — InfraNest en crée une pour vous lors de l'enregistrement.

Faire signaler votre tâche

1. Ouvrez le moniteur et repérez son URL de ping, ainsi qu'une commande prête à copier-coller.
2. Ajoutez cette ligne à la fin de votre script ou de votre tâche cron, afin qu'elle ne s'exécute que lorsque la tâche a réellement réussi :

0 3 * * *  /usr/local/bin/backup.sh && curl -fsS -m 10 --retry 3 https://your-infranest-url/api/heartbeat/your-uuid

Le && est important : il signifie que le signal n'est envoyé que si la sauvegarde elle-même s'est terminée avec succès. Une tâche échouée reste alors silencieuse, et c'est ce silence qui déclenche l'alerte.

3. Utilisez Copier plutôt que de retaper l'URL — l'identifiant qu'elle contient est unique à ce moniteur.

Ce qui se passe ensuite

• Chaque signal marque le moniteur comme Actif et enregistre l'heure comme son Dernier ping.
• Un moniteur tout juste créé reste en attente jusqu'à ce que sa première fenêtre soit passée, ce qui vous laisse le temps de connecter le signal sans être alerté à ce sujet.
• Si rien n'arrive dans l'Intervalle de vérification plus le Délai de grâce (secondes), le moniteur passe à Inactif et ouvre un incident, déclenchant vos canaux d'alerte habituels.
• Le signal suivant résout l'incident et vous informe que tout est revenu à la normale — vous n'avez pas besoin de le fermer manuellement.

NoteSuspendre le moniteur peut être utilisé sans risque sur un moniteur heartbeat : l'URL de ping continue de répondre normalement, donc une tâche qui l'appelle encore ne commencera pas à signaler des échecs. InfraNest arrête simplement de surveiller jusqu'à ce que vous sélectionniez Reprendre le moniteur.

TipTraitez l'URL de ping comme un secret. Quiconque la possède peut signaler votre tâche comme fonctionnelle — ce qui masquerait un véritable échec.

Dépannage

• Aucun heartbeat reçu pour le moment sur le moniteur signifie qu'InfraNest n'a rien reçu de la tâche du tout. Exécutez la ligne curl manuellement depuis la même machine : si cela fait passer le moniteur au vert, le problème vient de votre script, pas d'ici.
• Si la machine ne peut pas accéder à Internet en sortie, le signal ne peut pas arriver — autorisez le trafic HTTPS sortant vers InfraNest.
• Un moniteur qui alerte chaque nuit à la même heure a généralement un Délai de grâce (secondes) plus court que le temps d'exécution réel maximal de la tâche.