Formations — 1 037 leçons en français

Accueil › Node.js › Mesurer d'abord

Mesurer d'abord

Performance et montée en chargeavance

On n'optimise pas ce qu'on n'a pas mesuré. Et on ne mesure pas une moyenne.

La moyenne ment

const latences = [20, 20, 20, 20, 3000];   // 5 requêtes
const moyenne = latences.reduce((s, x) => s + x, 0) / latences.length;
console.log(moyenne);                      // 616 — personne n'a vécu ça

Aucun client n'a attendu 616 ms : quatre ont attendu 20 ms, un a attendu 3 secondes. Une moyenne de 80 ms peut cacher un dernier centile à 4 secondes, et c'est ce dernier que vivent les clients mécontents.

Les centiles, et rien d'autre

function centile(valeurs, p) {
  const t = [...valeurs].sort((a, b) => a - b);        // tri numérique
  const rang = Math.ceil((p / 100) * t.length);
  return t[Math.min(t.length - 1, Math.max(0, rang - 1))];
}

Trois chiffres suffisent : p50 dit l'expérience ordinaire, p95 dit la variabilité, p99 dit ce qui déclenche les tickets de support.

La métrique propre à Node

import { monitorEventLoopDelay } from "node:perf_hooks";

const h = monitorEventLoopDelay({ resolution: 10 });
h.enable();
setInterval(() => {
  console.log(`retard p99 : ${(h.percentile(99) / 1e6).toFixed(1)} ms`);
  h.reset();
}, 10_000);

Le retard de la boucle d'événements est la métrique la plus informative d'un service Node, parce qu'elle dit si le fil est occupé — pas si le processeur est chargé. Un processus qui sature son cœur affiche 12 % de charge sur huit cœurs.

L'ordre des opérations

  1. Une métrique de latence par centile, en production.
  2. Le retard de la boucle d'événements.
  3. Ensuite un profil, sur le point précis qui est lent.

Un profil pris avant d'avoir une métrique répond à une question qu'on ne s'est pas posée.

Les termes à connaître

Centile

La valeur sous laquelle tombe un pourcentage donné des mesures. Le 99e centile à 4 s signifie qu'une requête sur cent dépasse 4 secondes.

Moyenne

La somme divisée par le nombre de mesures. Elle écrase les extrêmes, donc elle cache exactement ce qui fait fuir les clients.

Retard de la boucle d'événements

L'écart entre l'instant où un minuteur devait se déclencher et celui où il se déclenche. La métrique la plus informative d'un service Node.

Débit

Le nombre de requêtes servies par seconde. Un débit annoncé sans la latence qui va avec ne veut rien dire.

Horloge monotone

process.hrtime.bigint(), qui ne recule jamais. Date.now() peut sauter en arrière si l'heure système est ajustée, et donner une durée négative.

Profil de processeur

Un échantillonnage de la pile d'appels, qui dit où le fil a passé son temps. On le prend quand on sait déjà que c'est lent.

Histogramme

Une répartition des mesures par tranche. C'est la structure qui permet de calculer des centiles sans garder toutes les valeurs.

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.