Registro y Monitorización
Reglas
- Registro estructurado: formato JSON con campos
timestamp, level, message, requestId, userId
- Niveles de registro:
error (roto), warn (degradado), info (eventos de negocio), debug (solo desarrollo)
- Usa Pino para logging en Node.js — rápido, estructurado, JSON por defecto
- Sentry para seguimiento de errores: inicializar temprano, capturar excepciones no manejadas, agregar contexto de usuario y migas de pan
- Correlacionar logs con IDs de solicitud — generar un UUID por solicitud, pasar a través de todas las llamadas de servicio
- Nunca registrar secretos, contraseñas, tokens o números de tarjeta de crédito completos — redactar campos sensibles
- Alertar sobre picos en la tasa de error, no sobre errores individuales — usar umbrales (p. ej., >5% de tasa de error en 5 minutos)
- Axiom/Datadog: enviar logs mediante OTLP o SDK nativo, agregar métricas personalizadas para KPIs de negocio
- Punto final de verificación de salud:
GET /health que devuelve { status: "ok" } con verificación de conectividad a la base de datos
- Monitorizar tiempos de respuesta en p50, p95, p99 — alertar sobre degradación en p95
Patrones
import pino from "pino";
const logger = pino({ level: process.env.LOG_LEVEL || "info" });
logger.info({ userId, action: "checkout", orderId }, "Pedido realizado");
logger.error({ err, requestId }, "El procesamiento del pago falló");
import * as Sentry from "@sentry/nextjs";
Sentry.init({ dsn: process.env.SENTRY_DSN, tracesSampleRate: 0.1 });
Evitar
console.log en producción — usar un registrador estructurado
- Registrar cada cuerpo de solicitud — registrar resúmenes, no cargas útiles
- Ignorar rechazos de promesas no manejadas — siempre capturarlos
- Fatiga de alertas por alertas ruidosas — ajustar umbrales, agrupar errores similares