Journaux structurés et traces distribuées

Les métriques répondent à une question : est-ce que le service va bien ? Elles sont incapables de répondre à la suivante : pourquoi cette requête-là a-t-elle échoué ? C'est une conséquence directe de leur nature. Une métrique agrège ; un centile 99 vous dit qu'un centième des requêtes dépasse deux secondes, jamais lesquelles ni pourquoi.

Cette leçon ferme donc la boucle ouverte par l'introduction : les métriques détectent, les journaux expliquent un cas particulier, les traces expliquent un cas particulier réparti sur plusieurs services. Les trois se complètent et ne se remplacent pas — mais elles ne se déploient pas au même moment, et confondre les deux dernières coûte cher.

Le journal structuré, et son seul champ indispensable

Un journal en texte libre est lisible par un humain qui sait déjà ce qu'il cherche. Un journal structuré est interrogeable, ce qui est une autre affaire.

# Avant : lisible, mais inexploitable en masse.
logger.info(f"Paiement refuse pour {client.id} : {erreur}")