fiado-logger

fiado-logger es una librería de logging configurada para simplificar el registro de logs en aplicaciones de AWS, utilizando AWS Lambda Powertools para una mejor integración y trazabilidad.

Caracteristicas

• Fácil integración con AWS Lambda.
• Formateo de logs coherente y legible.
• Compatible con el sistema de rastreo X-Ray de AWS.
• Personalización de logs basada en el contexto de ejecución de Lambda.

Instalación

npm install fiado-logger

Configuración

Antes de usar fiado-logger, configura las siguientes variables de entorno en tu aplicación Lambda para controlar el nivel de log:

• POWERTOOLS_LOG_LEVEL: Los niveles de log soportados son DEBUG,INFO, WARN, ERROR, CRITICAL y SILENT.
• SERVICE_NAME: Define el nombre del servicio que se utilizará en los logs para identificar tu lambda.

Aquí están los niveles disponibles y cuándo se recomienda usarlos:

• DEBUG (8): Utiliza este nivel para información detallada que es útil durante el desarrollo y la depuración. Proporciona el nivel más granular de detalle del log.
• INFO (12): Ideal para el seguimiento del flujo general de la aplicación. Úsalo para confirmar que las cosas están funcionando como se esperaba.
• WARN (16): Indicado para situaciones no ideales, pero que no impiden que la aplicación funcione. Ayuda a señalar excepciones que no se manejan o el uso de APIs obsoletas.
• ERROR (20): Reserva este nivel para errores que afectan la operación de la función pero que no necesariamente requieren que se apague toda la aplicación.
• CRITICAL (24): Para errores muy graves que pueden necesitar que la aplicación se detenga o reinicie. Por ejemplo, un error de configuración crítico o una falla del sistema.
• SILENT (28): Suprime todos los mensajes de log. Útil cuando necesitas desactivar temporalmente el registro sin cambiar el código fuente.

import { log } from 'fiado-logger';

Uso

Utiliza los métodos de logging para registrar mensajes a diferentes niveles de severidad.

log.info("Mensaje informativo", { additional: "info" });
log.warn("Mensaje de advertencia", { warning: "details" });
log.error("Mensaje de error", { error: "details" });
log.debug("Mensaje de debug", { debug: "info" });