Formations — 1 037 leçons en français

Accueil › Node.js › Les traces distribuées

Les traces distribuées

Observabilitéavance

Une trace montre où le temps est passé. Elle existe parce qu'une requête traverse plusieurs services et que personne ne peut reconstituer son parcours de tête.

Le vocabulaire

trace c1f3…        une requête de bout en bout
└─ segment         une unité de travail : nom, début, durée, parent, attributs

Un segment par frontière franchie : requête entrante, appel de base, appel sortant, traitement notable.

Ce qu'on lit dans une trace

POST /commandes                                     420 ms
├─ db.SELECT clients                                 12 ms
├─ stock.reserver                                    38 ms
│  └─ db.UPDATE stock                                31 ms
└─ paiement.autoriser                               350 ms
   └─ HTTP POST api.psp.example/auth                348 ms

Le temps propre de /commandes est 420 − 12 − 38 − 350 = 20 ms. Le service lui-même ne fait presque rien : le temps est chez le prestataire de paiement. Sans trace, on aurait optimisé le mauvais code.

La propagation

// service A — l'appel sortant porte le contexte
await fetch(url, { headers: { traceparent: contexteCourant() } });

L'en-tête traceparent du standard W3C Trace Context transporte l'identifiant de trace et celui du segment parent. Sans lui, chaque service produit une trace isolée et l'intérêt disparaît.

L'échantillonnage

Conserver toutes les traces coûte trop cher. Mais :

Échantillonner au hasard à 1 % conserve 1 % des requêtes lentes. Or ce sont les seules qu'on cherche.

D'où l'échantillonnage à la queue : décider après avoir vu la durée et le statut. On garde tout ce qui est lent ou en erreur, et une fraction du reste.

Les termes à connaître

Trace

L'ensemble des segments produits par une même requête à travers tous les services traversés. Elle est identifiée par un identifiant de trace unique.

Segment

Une unité de travail mesurée : un nom, un début, une durée, un parent, des attributs. L'anglais dit span, et le terme revient en entretien.

Propagation du contexte

Le passage de l'identifiant de trace et du segment parent au service suivant, par en-tête HTTP. Sans elle, chaque service produit une trace isolée.

Temps propre

La durée d'un segment moins le temps couvert par ses enfants. C'est le temps réellement passé dans le service lui-même, et la colonne qu'on trie en premier.

Échantillonnage

La décision de conserver ou non une trace. Conserver tout coûte trop cher ; conserver au hasard perd les cas intéressants.

Échantillonnage à la queue

Décider après coup, quand tous les segments sont là : on garde les traces lentes et celles en erreur, et une fraction des autres.

Segment orphelin

Un segment dont le parent déclaré est absent de la trace reçue. Signe habituel d'un contexte non propagé ou d'un segment perdu à l'export.

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.