docker logs
100%

Docker · Leçon 6

docker logs

Apprenez à lire la sortie recueillie pour un conteneur et à l’utiliser pour orienter le diagnostic.

Un conteneur nommé preview s’est arrêté. La liste des conteneurs affiche son état et son code de sortie. Pour savoir ce que le programme a signalé, consultez la sortie que Docker a recueillie pour ce conteneur.

Choisir un conteneur

Indiquez le nom du conteneur à docker logs. La commande peut lire une sortie conservée même si le conteneur est arrêté, pourvu qu’il existe encore. Dans cet exemple, une tâche courte a tenté de lire un fichier à l’emplacement /site/title.txt avant de s’arrêter.

$ docker logs preview
cat: can't open '/site/title.txt': No such file or directory

Ici, cat est le programme qui a tenté de lire le fichier. Le message indique le chemin que le programme n’a pas trouvé dans le conteneur.

Preview et report utilisent la même image. Quelle commande lit la sortie de preview ?

Lire le message dans son contexte

Les journaux contiennent les messages écrits par le programme. Un message de démarrage peut vous dire que le programme a commencé à écouter les requêtes. Une erreur peut indiquer l’opération qu’il n’a pas pu terminer. L’exemple signale un chemin introuvable dans preview. Vérifiez si le fichier devait se trouver exactement à cet emplacement. Le message vous indique par où commencer.

Que permet d’affirmer le message sur le fichier manquant ?

Regarder la sortie récente

Lorsqu’un conteneur produit beaucoup de lignes, utilisez --tail suivi d’un nombre. Docker renvoie au maximum ce nombre de lignes en partant de la fin de la sortie. Commencez avec quelques lignes, puis affichez-en davantage si le premier message d’erreur se trouve plus haut.

$ docker logs --tail 5 web

Terminal LabEx affichant l’erreur de fichier manquant dans preview et les cinq dernières lignes de web

Ces deux commandes consultent des conteneurs différents. Dans l’exemple LabEx, preview signale le fichier manquant et web indique que Nginx a démarré.

Vous voulez seulement les deux dernières lignes disponibles de web. Quelle commande convient ?

Que faire quand la sortie est vide ?

Docker ne peut afficher que la sortie qu’il a recueillie. Une commande peut s’exécuter sans rien afficher. Un programme peut aussi écrire ses messages dans un fichier dont Docker ne recueille pas le contenu. Si docker logs réussit sans rien afficher, utilisez docker ps -a pour consulter l’état du conteneur. Une sortie vide seule ne permet pas de déterminer cet état.

La tâche cleanup n’a pas de journal. Comment savoir si elle continue de tourner ou si elle s’est arrêtée ?

Leçon terminée

Vous avez terminé docker logs

Vous savez maintenant utiliser la sortie d’un conteneur pour décider quoi vérifier ensuite.

  • Lire la sortie recueillie pour un conteneur par son nom, même s’il est arrêté.

  • Utiliser un message du programme pour localiser le problème qu’il signale.

  • Limiter la sortie avec --tail.

  • Effectuer une autre vérification si les journaux laissent une question ouverte.

Conservez votre progression

Créez un compte gratuit pour enregistrer cette leçon et continuer sur n'importe quel appareil.

Créer un compte gratuit
Leçon Suivante
Retour à Docker