Ta tâche répond 200 et n’a rien fait : la détecter

C’est la raison d’être du module, et elle demande deux lignes de ta part.

Le cas : la sauvegarde nocturne tourne, répond 200 OK, ne sonne jamais l’alarme. Six mois plus tard on découvre que les fichiers sont vides depuis mars. Aucun ordonnanceur ne voit ça, parce que du point de vue HTTP tout va bien.

1. Déclare ce que tu as fait

Dans la réponse de ta tâche :

{ "tock": { "traite": 412, "erreurs": 3 } }

traite est le nombre d’éléments traités. LeTock apprend la médiane des dix dernières exécutions et alerte quand elle s’effondre — même sur un 200 parfait. Sans ce champ, cette détection est inactive, et c’est pour elle que le module existe.

Tu peux ajouter tes propres compteurs numériques au même niveau.

2. Exige autre chose que le code HTTP

Le champ attendu, dans la tâche :

"attendu": {
  "codes": [200],
  "contient": "Payer",
  "absent": "Erreur 500",
  "json": { "chemin": "resultat.statut", "egal": "ok" }
}

Quatre clés, et seulement ces quatre. Une clé inconnue est refusée avec un 422 champ_attendu — elle n’est pas ignorée en silence, ce qui donnerait une tâche qui a l’air réglée et n’assertit rien.

contient cherche dans le corps entier de la réponse, jusqu’à 64 Ko. C’est important sur les pages en rendu progressif : les premiers kilo-octets sont souvent la coquille et un « Chargement en cours », le contenu arrive après.

3. Essaie avant de créer

POST /api/v1/taches/{id}/essai

Elle appelle la cible, rend le code, la durée, les en-têtes et le verdict — et ne consomme aucun quota, n’entre dans aucune statistique. Essayer ne coûte rien, et le verdict de l’essai est exactement celui qu’aura l’exécution réelle.

Le réglage controle_volume

• zero (défaut) : alerte si traite vaut zéro alors qu’il ne le valait pas d’habitude.
• ratio : alerte sur un effondrement relatif de la médiane.
• off : aucune détection de volume. À choisir quand ta tâche délègue à quelque chose d’asynchrone — son traite ne voudrait alors rien dire.

Ce dernier cas est plus fréquent qu’on ne croit : si ta tâche déclenche un travail en arrière-plan et rend la main tout de suite, son battement prouve que l’ordonnanceur a déclenché, pas que le travail a réussi. Mieux vaut le savoir que de croire l’inverse.