Le mode « monitor » de bout en bout : clé de ping, fuseau, premier battement

Deux modes, et on choisit souvent le mauvais.

execute : LeTock appelle ton URL à l’heure. Tu n’installes rien.
monitor : ton ordonnanceur existant (pg_cron, crontab, GitHub Actions) nous pingue après avoir travaillé. L’absence de ping est l’alerte.

Prends monitor quand la tâche existe déjà et tourne bien — tu ne veux pas la déplacer, tu veux savoir si elle s’arrête.

La clé de ping se lit par l’API

POST /api/v1/taches → { "tache": { "cle_ping": "…", "url_ping": "https://letock.fr/api/ping/…" } }

Elle est aussi dans GET /api/v1/taches/{id}. Elle n’est pas dans la liste GET /api/v1/taches — c’est le détail ou la création.

Ce n’est pas un secret d’authentification : elle permet de signaler, pas d’accéder. Qui la connaît connaît déjà la tâche, puisque la même clé d’API la lit.

Puis, dans ta tâche, après le travail :

curl -fsS -X POST https://letock.fr/api/ping/TA_CLE \
  -H "Content-Type: application/json" \
  -d '{"tock":{"traite":412,"erreurs":3}}'

Le fuseau : celui de l’ORDONNANCEUR, pas le tien

C’est le piège le plus cher du module, et il se paie deux fois par an.

En mode monitor, le timezone que tu déclares doit être celui de la machine qui pingue. Un pg_cron sur Supabase tourne en UTC. Déclarer Europe/Paris ferait glisser la fenêtre de surveillance d’une heure aux changements d’heure, et produirait des alertes que personne ne saurait expliquer.

Vérifie chez toi : SHOW timezone; sur Postgres, timedatectl sur Linux.

Et fais toujours relire ton expression avant de créer la tâche — c’est gratuit et sans clé :

GET /api/v1/analyser?planning=0%202%20%20%20*&timezone=UTC

« surveillee: false » n’est pas une panne

Une tâche monitor n’alerte pas tant qu’elle n’a jamais reçu de battement. Le champ surveillee dit lequel des deux états tu regardes :

• false → créée, pas encore branchée. Normal juste après la création.
• true → un ping est arrivé. À partir de là, le silence devient une alerte.

« Cette tâche est tombée » et « cette tâche n’a jamais démarré » ne sont pas la même nouvelle, et la seconde n’a rien à faire dans ta boîte mail.

Ce que ça consomme

Chaque tâche porte executions_par_mois. Regarde-le avant de créer la cinquième : cinq tâches au quart d’heure demandent près de quinze mille exécutions par mois.