Structured Logging

Resumen

El logging tradicional es texto libre: User 42 placed order 789. Para buscar todos los eventos del usuario 42, necesitás parsear el texto con regex, lo cual es frágil y lento. Structured logging resuelve esto emitiendo logs como JSON con campos tipados.

Cada log es un objeto con campos como userId, orderId, duration, statusCode. Las plataformas de logging indexan estos campos automáticamente, permitiendo queries como userId:42 AND level:ERROR sin parsear texto.

Alcance y supuestos

Cubre structured logging, su diferencia con texto plano y herramientas. Asume familiaridad con logging.

Modelo mental

Una planilla de Excel versus un párrafo de texto. En la planilla, cada columna tiene un tipo y podés filtrar, ordenar y hacer tablas dinámicas. En el párrafo, tenés que leer todo y extraer los datos a mano.

Uso práctico

• ✅ Todo sistema en producción debería usar structured logging.
• ❌ Logs de desarrollo local donde console.log("llegó acá") alcanza.

Ejemplo trabajado: buscar errores por usuario

Con structured logging, el error se registra con campos tipados: userId, orderId, reason. En Grafana Loki, una query filtra por userId=42 y level=ERROR y encuentra todos los eventos en segundos, sin parsear texto libre.

Evidencia

• La mayoría de los loggers modernos —Winston, Serilog, Zap, Logrus— soportan structured logging.