Formations — 1 037 leçons en français

Accueil › Node.js › Les métriques qui servent

Les métriques qui servent

Observabilitéavance

Quatre métriques par service suffisent à savoir s'il va mal. Les signaux dorés :

Signal Ce qu'il mesure Type
Latence durée des requêtes, réussies et échouées séparément histogramme
Trafic requêtes par seconde compteur
Erreurs proportion de requêtes en échec compteur
Saturation la ressource la plus contrainte jauge

Trois types, trois usages

requetes.inc({ route, statut });        // compteur : ne descend jamais
connexions.set(pool.enAttente);          // jauge : instantané
duree.observe({ route }, 0.142);         // histogramme : distribution

Un compteur ne se lit pas en valeur absolue : on lit son taux. Un histogramme ne donne pas une moyenne utile : on lit ses centiles.

La moyenne ment

Latences : 10, 10, 10, 10, 10, 10, 10, 10, 10, 2000 ms
Moyenne  : 209 ms      ← personne n'a vécu cela
p50      : 10 ms
p99      : 2000 ms     ← ce que vit un client sur cent

On regarde le p50 pour le ressenti courant, le p99 pour le pire cas vécu.

La saturation en Node

import { monitorEventLoopDelay } from "node:perf_hooks";

const h = monitorEventLoopDelay({ resolution: 20 });
h.enable();
setInterval(() => {
  retardBoucle.set(h.mean / 1e6);   // nanosecondes → millisecondes
  h.reset();
}, 10_000);

Le retard de la boucle d'événements est la saturation propre à Node. Le processeur d'une machine à huit cœurs paraît calme pendant qu'un processus sature son unique fil.

Le piège qui coûte cher

requetes.inc({ chemin: req.url });          // ⛔ /clients/4821?tri=nom
requetes.inc({ route: req.route.path });    // ✅ /clients/:id

Chaque valeur distincte d'étiquette crée une série temporelle. Une URL contenant un identifiant en crée une par identifiant.

Les termes à connaître

Compteur

Une valeur qui ne fait que croître — requêtes servies, erreurs, octets envoyés. On ne lit jamais sa valeur brute, on lit sa dérivée : le taux par seconde.

Jauge

Une valeur instantanée qui monte et descend : connexions ouvertes, taille de file, mémoire du tas. Elle n'a de sens qu'au moment où on la lit.

Histogramme

Une distribution rangée en intervalles. C'est le seul type qui permette de calculer un centile de latence, et les intervalles sont choisis à l'avance.

Centile

La valeur sous laquelle tombe un pourcentage donné des mesures. Le 99ᵉ centile de latence décrit l'expérience du client le plus mal servi sur cent.

Gabarit de route

La forme d'une URL avec ses paramètres remplacés par des marqueurs — /clients/:id et non /clients/4821. C'est ce qui borne la cardinalité.

Retard de la boucle d'événements

Le délai entre le moment où une tâche devait être exécutée et celui où elle l'a été. En Node, c'est la mesure directe de la santé du fil unique.

Quatre signaux dorés

Latence, trafic, erreurs, saturation. Quatre métriques par service suffisent à savoir s'il va mal, avant toute métrique spécifique au métier.

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.