Accueil › Node.js › Journaux, métriques, traces
Journaux, métriques, traces
Observabilitéavance
Trois signaux, trois questions différentes. Les confondre est la première erreur d'observabilité.
| Signal | Répond à | Granularité |
|---|---|---|
| Métrique | Y a-t-il un problème ? | agrégée |
| Trace | Où le temps est-il passé ? | une requête, découpée |
| Journal | Que s'est-il passé exactement ? | une requête, en détail |
La métrique détecte
// un compteur et un histogramme, étiquetés par route et par statut
requetes.inc({ route: "/clients/:id", statut: 500 });
duree.observe({ route: "/clients/:id" }, 0.142);
Elle est agrégée, donc son coût ne dépend pas du trafic. On la consulte en permanence, on l'affiche sur un tableau de bord, on alerte dessus. Elle ne sait pas de quelle requête elle parle.
La trace localise
POST /commandes 312 ms
├─ auth.verifier 4 ms
├─ db.SELECT clients 11 ms
└─ paiement.autoriser 290 ms ← le coupable
Une fois qu'on sait qu'il y a un problème, la trace dit où. Sans elle, on devine en lisant du code.
Le journal explique
log.error({ requeteId: "a3f9", commandeId: 4821, code: "CARTE_REFUSEE" },
"autorisation refusée");
Il porte les identifiants et le contexte métier. C'est le dernier kilomètre du diagnostic, celui qui dit pourquoi cette requête-là a échoué.
L'ordre d'usage
Métrique → trace → journal. Une alerte sur une métrique, une trace lente pour trouver le segment fautif, un journal pour comprendre le cas. Chaque étape réduit le volume et augmente le détail.
Les termes à connaître
- Observabilité
La capacité à répondre à une question qu'on n'avait pas prévue, à partir de ce que le système émet déjà. La surveillance répond aux questions prévues ; l'observabilité aux autres.
- Journal
Un événement daté, décrivant ce qui s'est passé pour une exécution. Haute fidélité, coût de stockage élevé, interrogation lente.
- Métrique
Un nombre agrégé dans le temps, porteur d'étiquettes. Coût constant quel que soit le trafic, mais incapable de désigner une requête précise.
- Trace
L'enregistrement du parcours d'une requête à travers les services, découpé en segments avec leur durée. Elle montre où le temps est passé.
- Cardinalité
Le nombre de combinaisons d'étiquettes distinctes d'une métrique. C'est elle qui détermine le coût, et elle doit rester bornée.
- Agrégation
L'opération qui transforme des milliers d'événements en un seul nombre. Elle rend la métrique bon marché et lui fait perdre le détail individuel.
- Instrumentation
Le code qui émet les signaux. Elle se place aux frontières — entrée HTTP, appel de base, appel sortant — pas dans chaque fonction.
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.