Accueil › Node.js › Échecs, reprises et file morte
Échecs, reprises et file morte
Tâches de fond et filesavance
Un travail échoue. La question n'est pas s'il faut le reprendre, mais combien de fois et à quel rythme.
await file.ajouter("facture", { commandeId: 42 }, {
attempts: 5,
backoff: { type: "exponential", delay: 1000 },
});
Le délai exponentiel avec part aléatoire
function delaiReprise(tentative, alea) {
const base = Math.min(1000 * 2 ** (tentative - 1), 30_000);
return Math.round(base * (0.5 + alea * 0.5)); // alea ∈ [0, 1)
}
Deux idées, et chacune règle un problème distinct :
- l'exponentielle laisse au service le temps de se rétablir, au lieu de le frapper mille fois par seconde ;
- la part aléatoire évite que mille travaux tombés ensemble repartent ensemble et le fassent tomber à nouveau.
Le plafond est tout aussi nécessaire : sans lui, la dixième tentative attend un quart d'heure.
Au bout du compte, la file morte
Après le nombre maximal de tentatives, le travail quitte la file active pour une file morte avec son message d'erreur et son historique.
new Worker("factures", traiter, { connection })
.on("failed", (travail, err) => {
if (travail.attemptsMade >= travail.opts.attempts) {
logger.error({ id: travail.id, data: travail.data, err: err.message },
"travail en file morte");
}
});
Une file morte n'est pas une poubelle : c'est un endroit où quelqu'un regarde, avec une alerte quand elle se remplit. Une file morte que personne ne consulte est une perte de données avec une étape de plus.
Les termes à connaître
- Reprise
Redonner un travail échoué au consommateur, après un délai. Sans délai, on frappe un service déjà en difficulté.
- Délai exponentiel
Un délai qui double à chaque tentative : 1 s, 2 s, 4 s, 8 s. Il laisse le temps au service de se rétablir.
- Part aléatoire
Un écart tiré au hasard ajouté au délai, pour éviter que mille travaux repris en même temps repartent tous ensemble.
- File morte
L'endroit où va un travail qui a épuisé ses tentatives. Un endroit où l'on regarde, pas une poubelle.
- Travail empoisonné
Un travail qui échoue systématiquement. Repris sans limite et sans délai, il monopolise les consommateurs et bloque toute la file.
- Erreur permanente
Une erreur que la reprise ne corrigera jamais — données invalides, ressource supprimée. Elle ne doit pas consommer de tentatives.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.