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.