Formations — 1 037 leçons en français

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.

Lire l'explication détaillée et faire le quiz →

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.