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/:idet 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.
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.