Formations — 1 037 leçons en français

Accueil › Docker & conteneurs › Écrire les journaux sur la sortie standard

Écrire les journaux sur la sortie standard

Journaux et sondesintermediaire

Dans un conteneur, un journal n'est pas un fichier. C'est un flux. Le processus principal écrit sur sa sortie standard, le moteur capture ce flux et le confie à un pilote de journalisation qui décide de sa destination.

// serveur.js — le journal, c'est ça
console.log(JSON.stringify({
  niveau: "info",
  message: "requête traitée",
  route: "/commandes",
  dureeMs: 42,
}));

Aucun chemin de fichier, aucune rotation à gérer, aucun droit d'écriture à accorder. L'application ne sait pas où va sa sortie, et c'est exactement le but : la destination est une décision d'exploitation, pas une décision de code.

Pourquoi pas un fichier

Un fichier écrit à l'intérieur du conteneur pose trois problèmes d'un coup. Il atterrit dans la couche inscriptible, donc il disparaît avec le conteneur. Il n'apparaît pas dans docker logs, donc l'outillage standard ne le voit pas. Et il grossit sans limite, parce que personne n'a installé de rotation dans une image minimale.

Deux flux, un seul journal

La sortie standard et la sortie d'erreur sont toutes deux capturées. Le moteur retient leur origine, mais les restitue mélangées dans l'ordre d'arrivée. La séparation qui sert vraiment en production n'est pas celle des deux flux : c'est un champ niveau dans une ligne structurée, qu'un collecteur sait filtrer.

Une ligne par événement

Une trace d'exception sur quinze lignes devient quinze événements pour le collecteur. Les bibliothèques sérieuses sérialisent la trace dans un champ de la ligne, ce qui règle le problème sans configuration côté collecteur.

Les termes à connaître

Sortie standard

Le flux de sortie ordinaire d'un processus. Dans un conteneur, c'est le canal que le moteur branche sur le pilote de journalisation.

Sortie d'erreur

Le second flux, destiné aux messages d'anomalie. Le moteur le capture aussi et le marque comme tel, mais il arrive dans le même journal.

Pilote de journalisation

Le composant du moteur qui reçoit ce que le processus principal écrit sur ses deux flux et décide où cela va : un fichier sur l'hôte, un collecteur distant, ou rien.

Journal structuré

Une ligne de journal écrite comme un objet sérialisé plutôt que comme une phrase. Elle se filtre et s'agrège sans expression régulière.

Flux non bloquant

Un mode d'écriture où le processus ne s'arrête pas quand le destinataire du journal est saturé. Le moteur jette alors les messages excédentaires.

Corrélation

Le fait de rattacher plusieurs lignes de journal à une même requête, grâce à un identifiant transporté de service en service.

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.