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