docker logs
100%

Docker · Lección 6

docker logs

Aprende a leer la salida que Docker recoge de un contenedor y a usarla para elegir el siguiente paso de diagnóstico.

Un contenedor llamado preview ha terminado. La lista de contenedores indica su estado y su código de salida. Para averiguar qué comunicó el programa, consulta la salida que Docker recogió de ese contenedor.

Elegir un contenedor

Indica el nombre del contenedor a docker logs. El comando puede leer la salida conservada de un contenedor que se haya detenido y aún exista. En este ejemplo, una tarea breve intentó leer un archivo en /site/title.txt antes de terminar.

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

Aquí, cat es el programa que intentó leer el archivo. El mensaje indica la ruta que el programa no pudo encontrar dentro del contenedor.

Preview y report usaron la misma imagen. ¿Qué comando lee la salida de preview?

Interpretar el mensaje en su contexto

Los registros contienen mensajes que escribió el propio programa. Un mensaje de inicio puede indicar que el programa ya escucha peticiones. Un error puede mostrar qué operación quedó sin completar. En el ejemplo, preview señala que falta una ruta dentro del contenedor. Un buen siguiente paso es revisar si el archivo debía estar exactamente en esa ruta. El mensaje te indica por dónde empezar.

¿Qué permite afirmar el mensaje del archivo que falta?

Consultar la salida reciente

Si un contenedor ha producido muchas líneas, usa --tail seguido de un número. Docker devuelve como máximo ese número de líneas del final de la salida recogida. Empieza con unas pocas y amplía la consulta si el primer error aparece antes.

$ docker logs --tail 5 web

Terminal de LabEx con el error de archivo no encontrado de preview y las últimas cinco líneas de web

Los dos comandos consultan contenedores distintos. En la ejecución de LabEx, preview indica que falta el archivo y web comunica que Nginx se ha iniciado.

Solo quieres ver las dos últimas líneas disponibles de web. ¿Qué comando encaja?

Qué hacer si la salida está vacía

Docker solo puede mostrar la salida que recogió. Un comando puede ejecutarse sin imprimir mensajes. También es posible que el programa escriba en un archivo que Docker no recoge. Si docker logs se ejecuta correctamente y no imprime nada, usa docker ps -a para comprobar el estado del contenedor. La falta de registros no aclara por sí sola ese estado.

La tarea cleanup no tiene registros. ¿Cómo puedes saber si sigue en marcha o ya ha terminado?

Lección completada

Has completado docker logs

Ya puedes usar la salida de un contenedor para decidir qué comprobar después.

  • Leer la salida recogida de un contenedor por su nombre, aunque haya terminado.

  • Utilizar el mensaje del programa para localizar el problema que comunica.

  • Limitar la salida con --tail.

  • Elegir otra comprobación si los registros dejan una pregunta sin responder.

Guarda tu progreso

Crea una cuenta gratuita para guardar esta lección y continuar en cualquier dispositivo.

Crear una cuenta gratuita
Siguiente Lección
Volver a Docker