# Logging
faucet se encarga de hacer logs tanto de las solicitudes y respuestas HTTP como
de la salida estándar (`stdout`) y la salida de error (`stderr`) de los
procesos trabajadores. Esta sección describe cómo funcionan los logs en faucet
y cómo filtrar los logs.
## Estructura básica
Todos los logs generados por faucet siguen la siguiente estructura:
```
[<marca de tiempo> nivel <fuente>] <mensaje>
```
- La marca de tiempo tiene el formato `AAAA-MM-DDTHH:MM:SSZ` y está en UTC.
- El nivel puede ser uno de los siguientes:
- `ERROR`
- `WARN`
- `INFO`
- `DEBUG`
- `TRACE`
- La fuente es ya sea faucet o el nombre del trabajador `Worker::<id>`.
## Logging HTTP
Los logs HTTP se registran todos a nivel `INFO`. La fuente es el trabajador
encargado de manejar la solicitud. El mensaje tiene la siguiente forma:
```
<ip> "<método> <ruta> <protocolo>" <estado> "<agente-de-usuario>" <duración>
```
- `ip` es la dirección IP del cliente (determinada por la opción `--ip-from`).
- `método` es el método HTTP utilizado.
- `ruta` es la ruta de la solicitud.
- `protocolo` es la versión del protocolo HTTP utilizada.
- `estado` es el código de estado HTTP devuelto.
- `agente-de-usuario` es el agente de usuario del cliente.
- `duración` es el tiempo que tomó manejar la solicitud en milisegundos.
## Logging de trabajadores
Los logs de trabajadores se dividen en dos componentes: `stdout` y `stderr`.
`stdout` se loggea a nivel `INFO` y `stderr` se loggea a nivel `WARN`. La
fuente es el trabajador que posee el proceso subyacente. El mensaje es la línea
de salida del proceso.
## Filtrado de logs
Por defecto, faucet logea a nivel `INFO`, lo que significa que se muestran los
logs de `ERROR`, `WARN` e `INFO`. Para cambiar el nivel de log, utilice la
variable de entorno `FAUCET_LOG`.
> **Nota:** Plumber imprime errores que ocurren en puntos finales en `stdout`,
> por lo que si desea ver esos errores, deberá establecer el nivel de log en
> `INFO` o inferior. Shiny, por otro lado, imprime errores en `stderr`, por lo
> que deberá establecer el nivel de log en `WARN` o inferior para ver esos
> errores.