Formations — 1 037 leçons en français

Accueil › Spring Boot › Logs structurés et tracing distribué

Logs structurés et tracing distribué

Observabilitéavance

Spring Boot utilise SLF4J comme façade de logging et Logback comme implémentation par défaut. On règle les niveaux avec logging.level.* :

logging:
  level:
    root: INFO
    com.boutique.commande: DEBUG
  file:
    name: logs/application.log

Pour du contexte au-delà du simple message (identifiant de requête, utilisateur courant), on utilise le MDC (org.slf4j.MDC) : une carte clé/valeur propre à chaque thread, lue automatiquement par le pattern de log si elle contient les bonnes clés (%X{cle}).

En environnement distribué, le vrai problème n'est plus « ce log existe-t-il » mais « à quelle requête, dans quel service, appartient-il ». C'est le rôle de Micrometer Tracing, qui remplace Spring Cloud Sleuth depuis Spring Boot 3 : chaque requête reçoit un traceId (unique pour tout le parcours, potentiellement à travers plusieurs services) et un spanId (unique pour chaque étape), propagés entre services via l'en-tête HTTP standard traceparent. Micrometer Tracing place ces identifiants dans le MDC, donc ils apparaissent automatiquement dans les logs dès qu'on les inclut dans le pattern — la corrélation entre logs et traces se fait alors simplement en recherchant un traceId.

L'export des traces vers un outil (Zipkin, ou une plateforme compatible OpenTelemetry) passe par une dépendance de « bridge » (micrometer-tracing-bridge-brave ou micrometer-tracing-bridge-otel) et n'est réalisé, par défaut, que sur un échantillon des requêtes (management.tracing.sampling.probability), pour ne pas saturer le backend de tracing en production.

Les termes à connaître

SLF4J + Logback

Combinaison utilisée par défaut dans tous les starters Spring Boot : SLF4J est la façade de logging (l'API que le code appelle), Logback en est l'implémentation par défaut (celle qui écrit réellement les lignes). On peut la remplacer par Log4j2 en excluant Logback du starter.

logging.level.*

Propriété pour fixer le niveau de log par package ou par classe, ex. logging.level.com.boutique.commande=DEBUG. Le niveau s'applique à ce package et à tous ses sous-packages, sauf niveau plus spécifique défini en dessous.

MDC (Mapped Diagnostic Context)

Contexte clé/valeur propre à chaque thread (org.slf4j.MDC), utilisé pour enrichir chaque ligne de log sans la répéter dans chaque appel (ex. un identifiant de requête). Micrometer Tracing y place automatiquement traceId et spanId pendant la durée d'un span.

Logs structurés (JSON)

Format de log où chaque ligne est un objet JSON (un champ par donnée) plutôt qu'une ligne de texte formatée, pour être indexé facilement par un outil comme Elasticsearch ou Loki. S'obtient nativement à partir de Spring Boot 3.4 (propriétés logging.structured.format.*) ou, sur des versions antérieures, via un encodeur Logback JSON tiers (logstash-logback-encoder).

Micrometer Tracing

Façade de tracing distribué intégrée à Spring Boot 3, qui remplace Spring Cloud Sleuth (arrêté avec l'arrivée de Boot 3). Elle instrumente automatiquement les appels HTTP entrants/sortants et les publie via un pont (« bridge ») vers Brave (Zipkin) ou OpenTelemetry.

traceparent

En-tête HTTP standard (spécification W3C Trace Context) qui transporte l'identifiant de trace et de span d'un service à l'autre, ex. traceparent: 00-<traceId>-<spanId>-01. C'est ce qui permet de relier les spans de plusieurs microservices dans une même trace.

management.tracing.sampling.probability

Proportion des requêtes réellement tracées et exportées, entre 0.0 et 1.0. Valeur historiquement modeste par défaut (héritée de Spring Cloud Sleuth) : en local, il est courant de la monter à 1.0 pour voir chaque requête dans l'outil de tracing.

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.