# 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](/engine/logging/configure/).

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](https://pkg.go.dev/time#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)<br> |

 | `-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)<br> |




## Ejemplos

### Recuperar registros hasta un punto específico en el tiempo (--until) {#until}

Para recuperar los registros antes de un punto específico en el tiempo, ejecuta:

```console
$ 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
```