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
traceIdetspanId. 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.
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.