Formations — 1 037 leçons en français

Accueil › Fullstack Angular + Spring Boot › Suivre une requête du clic jusqu'à la base

Suivre une requête du clic jusqu'à la base

Mettre un fullstack en productionavance

Sur un serveur qui traite des centaines de requêtes en parallèle, « il y a eu une erreur à 14 h 32 » ne suffit pas. Il faut un fil conducteur.

Côté back, deux dépendances et une propriété :

<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-tracing-bridge-brave</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
management:
  tracing:
    sampling:
      probability: 1.0        # tout tracer en développement
logging:
  pattern:
    level: "%5p [${spring.application.name:},%X{traceId:-},%X{spanId:-}]"

Chaque ligne de journal porte alors l'identifiant de trace :

INFO  [boutique-api,3f2a8c1d9e4b7a62,9e4b7a62] c.b.CommandeService : Création de la commande pour le client 42
WARN  [boutique-api,3f2a8c1d9e4b7a62,1a2b3c4d] c.b.StockService    : Stock insuffisant pour le produit 10

Et la boucle se ferme en renvoyant cet identifiant au front sur les erreurs :

@ExceptionHandler(Exception.class)
ProblemDetail inattendue(Exception ex) {
    String trace = Optional.ofNullable(traceur.currentSpan())
            .map(s -> s.context().traceId())
            .orElse("-");
    log.error("Erreur inattendue", ex);

    ProblemDetail p = ProblemDetail.forStatus(HttpStatus.INTERNAL_SERVER_ERROR);
    p.setDetail("Une erreur inattendue est survenue.");
    p.setProperty("code", "ERREUR_INTERNE");
    p.setProperty("traceId", trace);
    return p;
}

L'utilisateur voit « référence 3f2a8c1d… », et cette référence retrouve toutes les lignes de journal de sa requête.

Les termes à connaître

Trace et segment (span)

Une trace représente le parcours complet d'une requête à travers les composants ; chaque étape mesurée est un segment. Un identifiant de trace commun relie tous les segments d'une même requête, ce qui permet de les retrouver ensemble.

traceparent

En-tête HTTP normalisé (format W3C Trace Context) qui transporte l'identifiant de trace d'un composant à l'autre : traceparent: 00-<traceId>-<spanId>-01. C'est le format produit par défaut par Spring Boot 3 en sortie, et il accepte en entrée les formats connus (W3C et B3).

Micrometer Tracing

Couche d'abstraction de traçage de Spring Boot 3, branchée sur une implémentation (Brave ou OpenTelemetry) par une dépendance « pont ». Elle instrumente automatiquement les requêtes web, les clients HTTP et les accès aux données.

MDC (Mapped Diagnostic Context)

Contexte de journalisation par thread, dans lequel Micrometer place traceId et spanId. En les ajoutant au format des journaux, chaque ligne devient reliable à la requête qui l'a produite.

Échantillonnage (sampling)

Proportion de requêtes réellement tracées (management.tracing.sampling.probability). À 1.0, tout est tracé : acceptable en développement, coûteux en production sur un fort trafic où l'on descend souvent à quelques pourcents.

Corrélation côté front

Pratique consistant à ce que le front génère ou relaie un identifiant par requête (ou par session), afin qu'un incident signalé par un utilisateur soit retrouvable dans les journaux du back. Sans elle, une capture d'écran ne donne aucun point d'entrée.

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.