Sachez quand une tâche cron, une sauvegarde ou une tâche planifiée s’arrête sans bruit

Fonctionnement

Les moniteurs de sites et de serveurs vérifient de l’extérieur. Une tâche qui tourne selon son propre horaire n’a rien à visiter : un heartbeat fonctionne donc dans l’autre sens, c’est la tâche qui appelle Monitorizer.

Mise en place en trois étapes

1. 1

   Ajoutez un moniteur heartbeat

   Sur le site : Moniteurs, Ajouter un moniteur, Heartbeat. Dans l’app Mac : Ajouter, Heartbeat. Donnez-lui un nom clair, comme « Sauvegarde nocturne, serveur boutique ». Les heartbeats demandent votre compte, puisque les appels arrivent sur le site.

2. 2

   Collez votre ligne crontab

   Collez la ligne de la tâche depuis crontab -e : l’horaire, un nom et un délai de grâce sont remplis pour vous. Pas de ligne crontab (Windows, GitHub Actions) ? Réglez l’intervalle ou l’horaire à la main. Vérifiez le fuseau horaire : celui de la machine qui exécute la tâche.

3. 3

   Recopiez la ligne

   Enregistrez. La page du moniteur vous rend la ligne avec le signal ajouté, en version simple ou avec signalement des échecs. Remplacez l’ancienne ligne par celle-ci : le premier signal apparaît quelques secondes après la prochaine exécution.

Intervalle ou horaire cron ?

Un horaire cron a cinq champs, séparés par des espaces :

┌───────── minute (0 à 59)
│ ┌─────── heure (0 à 23)
│ │ ┌───── jour du mois (1 à 31, L = dernier)
│ │ │ ┌─── mois (1 à 12)
│ │ │ │ ┌─ jour de la semaine (0 à 6, dimanche = 0)
│ │ │ │ │
0 3 1 * *

Choisissez le fuseau horaire de la machine qui exécute la tâche, pour que « 03:00 » veuille dire la même chose des deux côtés. Les changements d’heure sont gérés pour vous.

Choisir le délai de grâce

Le délai de grâce est le temps pendant lequel un appel peut encore arriver après l’heure prévue. Il couvre la durée de la tâche et les petits retards. Trop court, il donne de fausses alertes ; trop long, il retarde les vraies.

• Une tâche rapide (quelques secondes) toutes les 5 à 15 minutes : 5 minutes.
• Une tâche horaire de quelques minutes : 15 à 30 minutes.
• Une sauvegarde nocturne de 20 minutes : 1 heure.
• Une tâche hebdomadaire ou mensuelle qui peut durer des heures : 2 à 6 heures.
• En règle générale : la plus longue durée jamais observée, plus une marge.

L’adresse de signal

Les requêtes GET, POST et HEAD fonctionnent toutes : tout outil capable d’ouvrir une adresse web peut envoyer un signal.

Gardez l’adresse privée, comme un mot de passe : quiconque la connaît peut envoyer des appels pour ce moniteur. Si elle fuit, supprimez le moniteur et créez-en un nouveau, qui aura une nouvelle adresse.

Exemples

Remplacez YOUR-ADDRESS par l’adresse affichée sur la page de votre moniteur (avec des boutons pour la copier).

# L’appel n’est fait que si la sauvegarde a réussi (&&).
0 3 * * * /home/me/backup.sh && curl -fsS -m 10 --retry 3 -o /dev/null https://monitorizer.ai.tn/hb/YOUR-ADDRESS

#!/bin/sh
# Signale le début, la fin, et un échec avec la fin du journal.
HB=https://monitorizer.ai.tn/hb/YOUR-ADDRESS
curl -fsS -m 10 -o /dev/null $HB/start
if /home/me/backup.sh > /tmp/backup.log 2>&1; then
  curl -fsS -m 10 -o /dev/null $HB
else
  tail -c 1000 /tmp/backup.log | curl -fsS -m 10 -o /dev/null --data-binary @- $HB/fail
fi

# /etc/systemd/system/backup.service
[Service]
Type=oneshot
ExecStart=/home/me/backup.sh
ExecStartPost=/usr/bin/curl -fsS -m 10 -o /dev/null https://monitorizer.ai.tn/hb/YOUR-ADDRESS

# Lancez ce script depuis la tâche planifiée.
& "C:\Scripts\backup.ps1"
if ($?) { Invoke-RestMethod https://monitorizer.ai.tn/hb/YOUR-ADDRESS }
else { Invoke-RestMethod -Method Post -Body "Backup failed" https://monitorizer.ai.tn/hb/YOUR-ADDRESS/fail }

# .github/workflows/nightly.yml
on:
  schedule:
    - cron: "0 3 * * *"
jobs:
  nightly:
    runs-on: ubuntu-latest
    steps:
      - run: ./nightly.sh
      - run: curl -fsS -m 10 ${{ secrets.HEARTBEAT_URL }}
      - if: failure()
        run: curl -fsS -m 10 ${{ secrets.HEARTBEAT_URL }}/fail

<?php
// À la fin de la tâche planifiée.
run_my_task();
file_get_contents('https://monitorizer.ai.tn/hb/YOUR-ADDRESS');
// WordPress: wp_remote_get('https://monitorizer.ai.tn/hb/YOUR-ADDRESS');

try {
  await runJob();
  await fetch("https://monitorizer.ai.tn/hb/YOUR-ADDRESS");
} catch (error) {
  await fetch("https://monitorizer.ai.tn/hb/YOUR-ADDRESS/fail", { method: "POST", body: String(error) });
}

import urllib.request

try:
    run_job()
    urllib.request.urlopen("https://monitorizer.ai.tn/hb/YOUR-ADDRESS", timeout=10)
except Exception as error:
    urllib.request.urlopen("https://monitorizer.ai.tn/hb/YOUR-ADDRESS/fail", data=str(error).encode(), timeout=10)

Questions