Surveiller une tâche planifiée

Un site qui tombe se voit. Une sauvegarde nocturne qui ne tourne plus, non. Un moniteur heartbeat attend un signal de ta tâche : si le signal n’arrive pas dans les temps, Status alerte.

Avant de commencer : une tâche capable d’appeler une adresse HTTPS en fin d’exécution (une ligne de curl suffit), et une organisation dans Status.

Créer le heartbeat

1. Ouvre Moniteurs, puis clique Créer un heartbeat.
2. Donne un nom clair, par exemple « Sauvegarde nocturne ».
3. Règle le Signal attendu : le délai maximal entre deux signaux. Pour une sauvegarde quotidienne, 86 400 secondes.
4. Règle la Tolérance : le retard admis avant l’alerte. 300 secondes par défaut.
5. Enregistre. Status affiche l’Adresse de ping propre à ce heartbeat.

Garde l’adresse de ping secrète : qui la connaît peut signaler un succès à ta place.

Tant qu’aucun signal n’est arrivé, le heartbeat reste en attente, et aucune fausse alerte ne part.

Ajouter le signal à la tâche

Ajoute un appel en fin de tâche :

# en fin de script, après une réussite
curl -fsS -m 10 --retry 3 "<adresse de ping>" > /dev/null

Pour signaler un échec, appelle la même adresse suivie de /fail. Pour mesurer la durée, appelle /start au début. Le détail de chaque adresse est dans la référence des heartbeats.

N’entoure pas l’appel d’un bloc qui masque les erreurs : si la tâche échoue, le signal doit échouer aussi.

Tester

Lance la tâche à la main une fois. Le heartbeat reçoit son premier signal, et l’heure du Dernier signal s’affiche. Pour tester l’alerte, laisse passer le signal attendu et la tolérance sans rien envoyer : l’alerte de panne part.

Si ça ne marche pas

• Le heartbeat reste en attente. Aucun signal n’est arrivé. Vérifie que la commande a bien été exécutée, et regarde son code de retour.
• Une alerte part alors que la tâche a tourné. La tâche a peut-être fini après le signal attendu plus la tolérance. Augmente la tolérance, ou mesure la durée avec /start.
• Le signal est refusé. L’adresse a été mal copiée. Recopie-la depuis la fiche du heartbeat.
• Le serveur ne joint pas Status. Un pare-feu sortant bloque l’appel HTTPS. Autorise la sortie vers Status.
• Le corps du signal est trop gros. Un corps de plus de 100 Ko est refusé. Pour les sorties longues, utilise /log : il ne change pas l’état du heartbeat.