docker container logs
| Descripción | Obtiene los registros (logs) de un contenedor |
|---|---|
| Uso | docker container logs [OPTIONS] CONTAINER |
| Alias | docker logs |
Descripción
El comando docker logs recupera en lote los registros que estén presentes en el momento de la ejecución.
Para obtener más información sobre cómo seleccionar y configurar los controladores de registros (logging drivers), consulta Configurar controladores de registros.
El comando docker logs --follow continuará transmitiendo en tiempo real la nueva salida de
STDOUT y STDERR del contenedor.
Pasar un número negativo o un valor no entero a --tail no es válido y, en ese caso,
el valor se establece en all.
El comando docker logs --timestamps agregará una marca de tiempo RFC3339Nano
, por ejemplo 2014-09-16T06:17:46.000000000Z, a cada
entrada de registro. Para garantizar que las marcas de tiempo estén alineadas, la
parte de los nanosegundos de la marca de tiempo se rellenará con ceros cuando sea necesario.
El comando docker logs --details agregará atributos adicionales, como
variables de entorno y etiquetas, que se proporcionaron a --log-opt al crear el
contenedor.
La opción --since muestra únicamente los registros del contenedor generados después de
una fecha determinada. Puedes especificar la fecha como una fecha RFC 3339, una marca de
tiempo UNIX o una cadena de duración de Go (por ejemplo, 1m30s, 3h). Además del formato de fecha
RFC3339, también puedes usar RFC3339Nano, 2006-01-02T15:04:05,
2006-01-02T15:04:05.999999999, 2006-01-02T07:00 y 2006-01-02. Se utilizará la zona
horaria local del cliente si no proporcionas un desfase de zona horaria Z o
+-00:00 al final de la marca de tiempo. Al proporcionar marcas de tiempo Unix,
ingresa segundos[.nanosegundos], donde segundos es el número de segundos
transcurridos desde el 1 de enero de 1970 (medianoche UTC/GMT), sin contar los segundos
bisiestos (también conocido como época Unix o tiempo Unix), y el campo opcional .nanosegundos es una
fracción de segundo de no más de nueve dígitos de longitud. Puedes combinar la
opción --since con una o ambas opciones --follow o --tail.
Opciones
| Opción | Predeterminado | Descripción |
|---|---|---|
--details | Muestra detalles adicionales proporcionados a los registros | |
-f, --follow | Sigue la salida de los registros | |
--since | Muestra los registros desde una marca de tiempo (por ejemplo, 2013-01-02T13:23:37Z) o relativos (por ejemplo, 42m para 42 minutos) | |
-n, --tail | all | Número de líneas a mostrar desde el final de los registros |
-t, --timestamps | Muestra las marcas de tiempo | |
--until | API 1.35+
Muestra los registros antes de una marca de tiempo (por ejemplo, 2013-01-02T13:23:37Z) o relativos (por ejemplo, 42m para 42 minutos) |
Ejemplos
Recuperar registros hasta un punto específico en el tiempo (--until)
Para recuperar los registros antes de un punto específico en el tiempo, ejecuta:
$ docker run --name test -d busybox sh -c "while true; do $(echo date); sleep 1; done"
$ date
Tue 14 Nov 2017 16:40:00 CET
$ docker logs -f --until=2s test
Tue 14 Nov 2017 16:40:00 CET
Tue 14 Nov 2017 16:40:01 CET
Tue 14 Nov 2017 16:40:02 CET