Formations — 1 037 leçons en français

Accueil › Docker & conteneurs › La rotation des journaux, et ce qu'elle efface

La rotation des journaux, et ce qu'elle efface

Journaux et sondesintermediaire

Écrire sur la sortie standard ne suffit pas : il faut savoir où le moteur range ce qu'il capture, et combien de temps il le garde. Avec le pilote par défaut, chaque conteneur a un fichier sur l'hôte, et ce fichier n'a pas de limite tant qu'on n'en pose pas une.

services:
  api:
    image: exemple/api:1.4.0
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

Trois fichiers de dix mégaoctets : le journal occupe au plus trente mégaoctets par conteneur, et le plus ancien est supprimé quand le quatrième commence.

La fenêtre ne se règle pas en heures

On configure une taille, pas une durée. La durée couverte en découle, et elle dépend du débit : trente mégaoctets valent une journée pour un service calme et vingt minutes pour le même service en incident. La fenêtre se referme au pire moment, parce qu'un incident fait exploser le volume journalisé.

Le réglage se fait à deux endroits

Par conteneur, comme ci-dessus. Ou par défaut, dans la configuration du démon, ce qui couvre aussi les conteneurs lancés sans y penser. La deuxième option est la seule qui protège contre l'oubli, et l'oubli est la cause habituelle d'un disque d'hôte saturé par un seul conteneur bavard.

Si les journaux partent ailleurs

Dès qu'un collecteur central reçoit les journaux, la rotation locale n'est plus une archive mais un tampon. On la garde courte, et l'historique long vit dans le collecteur.

Les termes à connaître

Rotation

Le mécanisme qui limite la place occupée par un journal : au-delà d'une taille, le fichier courant est archivé et un nouveau commence ; au-delà d'un nombre d'archives, la plus ancienne est supprimée.

Fenêtre de rétention

La durée réellement couverte par les fichiers conservés. Elle ne se règle pas directement : elle découle de la taille gardée et du débit de journalisation.

Pilote par défaut

Le pilote de journalisation appliqué à tout conteneur qui n'en demande pas un autre. Il se configure au niveau du démon, pas de l'image.

Expédition

Le fait d'envoyer les journaux vers un collecteur central. La rotation locale devient alors un tampon, pas une archive.

Troncature à la copie

Une technique de rotation où l'archiveur copie le fichier puis le vide au lieu de le renommer, pour que le processus qui l'a ouvert continue d'écrire au bon endroit.

Fichier orphelin

Un fichier renommé ou supprimé alors qu'un processus le tient encore ouvert. Il n'apparaît plus dans l'arborescence, mais il occupe toujours le disque tant que le processus vit.

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.