OpenTelemetry rastrea una request del frontend a la base de datos y muestra dónde se rompió. Sin instrumentación distribuida, debuguear un flujo que atraviesa cinco servicios exige lectura manual de logs en cada sistema. La especificación de OpenTelemetry (proyecto de CNCF) define tres pilares: traces, métricas y logs.
Los tres pilares
Traces: el camino completo de una request. Cada servicio agrega un span. El trace muestra dónde se gastó el tiempo y dónde ocurrió el error.
Métricas: números agregados. Requests por segundo, latencia p99, tasa de error. Las métricas indican que algo está mal.
Logs: eventos estructurados. Los logs indican qué pasó. Los traces indican dónde. Las métricas indican cuánto.
Instrumentación automática
OTel ofrece instrumentación automática para frameworks populares. En Node.js, el paquete @opentelemetry/auto-instrumentations-node instrumenta Express, PostgreSQL, Redis, Kafka sin cambiar código. La documentación de OpenTelemetry lista paquetes de auto-instrumentación para Java, Python, Go, .NET y otros lenguajes.
Instrumentación manual
Para código manual, agregas spans explícitamente. Un span es una operación con nombre, timestamp y atributos. Ej: span "process-payment" con atributos "payment-method", "amount", "currency".
Qué instrumentar
Fronteras de servicio: toda llamada HTTP, gRPC o de cola entra y sale de un span. Sin este rastreo, no sabes qué servicio causó el problema.
Operaciones de base de datos: las queries lentas son la causa número uno de problemas de performance. Instrumenta queries con nombre, tabla y duración.
Operaciones de negocio: checkout, pago, onboarding. Estas operaciones tienen impacto directo en el negocio. Instrumenta con atributos de negocio.
Errores comunes
Instrumentación excesiva: operaciones triviales, cache hits y health checks no necesitan span. Instrumenta lo que importa para debugging.
Contexto no propagado: si el trace ID no propaga entre servicios, tienes traces rotos. Garantiza que el header traceparent se propaga en todas las llamadas.
Costo ignorado: tracing tiene costo. El sampling reduce el costo. Muestrea 100% de errores, 10% de successes. No necesitas todos los traces para debugging.
Limitaciones
OTel no resuelve falta de logs, falta de métricas o falta de instrumentación manual en código legado. La herramienta estandariza recolección y exportación, pero la calidad de la instrumentación depende del equipo.
¿Te gustó el contenido?
Construyo productos web y soluciones con IA de la manera correcta — arquitectura sólida, código sostenible y entrega real.
Hablemos