# Seguimiento de registros con keenauth logs tail

`keenauth logs tail` sigue los registros del entorno (inicios de sesión, sesiones, tokens, MFA, protección contra ataques) mientras trabaja, igual que `tail -f`. Primero muestra los registros más recientes, del más antiguo al más nuevo, y después comprueba si hay registros nuevos a intervalos fijos y los muestra en cuanto aparecen. Pulse Ctrl-C para detenerlo; el comando termina entonces con el código 0.

El comando lee los mismos registros que `keenauth logs list` y requiere el mismo permiso (`logs:read`). Funciona con una clave de API y con una sesión de `keenauth login`.

## Uso

```sh
keenauth logs tail --type authentication. --user usr_01j9z3k4m5n6p7q8r9s0t1v2w3
```

| Opción | Descripción |
|---|---|
| `--type` | Prefijo del tipo de registro, por ejemplo `authentication.` o `session.created`. Separados por comas o repetidos, como máximo 20; se muestra un registro que coincida con cualquiera de ellos. |
| `--user` | Solo los registros de este usuario (`usr_…`). |
| `--org` | Solo los registros de esta organización (`org_…`). |
| `--limit` | Número de registros recientes que se muestran antes de empezar el seguimiento, de 1 a 100. Predeterminado: 20. |
| `--interval` | Tiempo entre dos comprobaciones, de `1s` a `60s`. Predeterminado: `5s`. |
| `--output`, `-o` | `table`, `json` o `yaml`. Sin esta opción, la CLI muestra una tabla en un terminal y JSON en caso contrario. |

Un filtro o un intervalo no válidos detienen el comando con el código 2 antes de enviar ninguna solicitud.

## Salida

- `table`: una línea por registro con la hora (UTC), el tipo, el resultado, el usuario, la organización y el ID del registro; un valor ausente se muestra como `-`.
- `json`: un objeto JSON por línea (JSON delimitado por saltos de línea), el mismo objeto que devuelve `keenauth logs get`. Es el valor predeterminado cuando la salida estándar no es un terminal, de modo que puede canalizarla, por ejemplo, a `jq`.
- `yaml`: un documento YAML por registro, cada uno empieza con `---`.

```sh
keenauth logs tail --type authentication.failed -o json | jq -r '.ip_country'
```

La dirección IP, el user agent y la pista del identificador solo aparecen si su credencial tiene los permisos descritos en [la API de registros](/docs/api/management/logs/list).

## Cómo funciona el seguimiento

La API de registros devuelve primero los registros más nuevos y no tiene un parámetro de espera, así que el comando consulta periódicamente. Después de la primera página, cada comprobación pide los registros con una hora igual o posterior a la más reciente que ya se ha mostrado y omite los registros ya mostrados, así que ningún registro aparece dos veces. Una comprobación recorre las páginas de resultados hasta obtener todos los registros nuevos, con un máximo de 2000 registros por comprobación. Los registros más antiguos que el periodo de retención de su plan no se devuelven.

## Códigos de salida

| Código | Significado |
|---|---|
| `0` | Detenido con Ctrl-C. |
| `1` | Error del servidor o fallo de red. |
| `2` | Error de uso: un filtro, límite, intervalo o formato de salida no válido. No se envió ninguna solicitud. |
| `3` | Falta la credencial o el servidor respondió `401` o `403`. |
| `4` | El plan no incluye la función (`403` con `plan_feature_unavailable`). |