Configuración del Logger

Configura el sistema de registro para tu instancia de Gigantics, incluyendo niveles de registro y formatos de salida.

Propiedades de Configuración

La configuración del logger puede establecerse en tu archivo config/default.yaml:

logger:
  level: 'http'
  output: 'dev'

Detalles de las Propiedades

level

• Tipo: Cadena
• Predeterminado: 'silly' en desarrollo, 'http' en producción, 'test' en entorno de prueba
• Descripción: Controla la verbosidad de la salida de registros. Niveles disponibles (en orden de verbosidad):
  • error - Solo errores
  • warn - Errores y advertencias
  • info - Errores, advertencias y mensajes informativos
  • http - Registro de solicitudes HTTP y niveles superiores
  • verbose - Información detallada
  • debug - Información de depuración
  • silly - Todo incluyendo mensajes triviales

output

• Tipo: Cadena
• Predeterminado: 'dev'
• Descripción: Controla el formato de salida de los registros.
  • 'dev' - Formato legible por humanos y coloreado para desarrollo
  • Otros formatos pueden especificarse según sea necesario

Ejemplos

Registro en Desarrollo

logger:
  level: 'silly'
  output: 'dev'

Registro en Producción

logger:
  level: 'info'
  output: 'dev'

Registro Mínimo

logger:
  level: 'error'
  output: 'dev'

Registro HTTP Detallado

logger:
  level: 'http'
  output: 'dev'

Valores Predeterminados Basados en Entorno

La aplicación establece automáticamente diferentes niveles de registro basados en el entorno:

• Desarrollo: Nivel silly para máximo detalle
• Producción: Nivel http para registro de solicitudes HTTP
• Prueba: Nivel test para entorno de testing

Puedes verificar tu entorno con:

echo $NODE_ENV

Anulación por Línea de Comandos

Puedes anular el nivel de registro usando la línea de comandos:

# Establecer nivel de registro a debug
./gig start --logLevel=debug
 
# Establecer nivel de registro a verbose
./gig start --logLevel=verbose

Niveles de Registro Disponibles

Mejores Prácticas

1. Producción: Usa niveles http o info para evitar volúmenes excesivos de registros
2. Desarrollo: Usa niveles silly o debug para solución detallada de problemas
3. Monitoreo: Asegúrate de que los registros se roten y almacenen adecuadamente
4. Seguridad: Ten cuidado al registrar información sensible
5. Rendimiento: Niveles de registro más bajos pueden mejorar el rendimiento en entornos de alto tráfico

Probando Cambios de Configuración

Después de modificar la configuración del logger:

1. Reinicia la aplicación:

   ./gig stop
   ./gig start

2. Realiza algunas acciones en la aplicación para generar entradas de registro

3. Verifica el archivo de registro especificado en la configuración de logs para confirmar que el nuevo nivel de registro está activo