¿Qué es OpenTelemetry y cómo ayuda a encontrar errores entre servicios?
Publicado el 2026-10-20 por frfrand
OpenTelemetry explicado con ejemplos: traces, spans, métricas, contexto distribuido y límites de instrumentación.
OpenTelemetry es un proyecto abierto que ofrece APIs, SDK, herramientas y convenciones para producir y transportar datos de telemetría, como trazas, métricas y logs. Ayuda a observar aplicaciones sin atar toda la instrumentación a un único proveedor.
Su nombre aparece mucho cuando una web se divide en varios servicios y descubrir dónde ocurre un fallo empieza a ser difícil.
¿Qué problema resuelve?
Imaginá que una compra pasa por una API, un servicio de inventario, uno de pagos y una base de datos. Para el usuario todo es un solo botón. Para el equipo técnico son varias operaciones diferentes.
Si el pago tarda seis segundos, necesitás saber dónde se perdió ese tiempo. OpenTelemetry permite instrumentar esos componentes de manera consistente y relacionar información entre ellos.
No identifica automáticamente la causa de cada error: proporciona mecanismos para reunir evidencia.
¿Qué es un span?
Un span representa una operación con un inicio y un final. Puede corresponder a una solicitud HTTP, una consulta de base de datos o una llamada entre servicios.
Varios spans relacionados forman una traza. El identificador de traza permite correlacionar partes de una misma operación, incluso si cruzan diferentes procesos.
Esto exige propagar correctamente el contexto. Si un servicio pierde esos identificadores, parte del recorrido puede aparecer desconectado.
Instrumentación automática y manual
Algunos frameworks y bibliotecas permiten instrumentación automática de operaciones comunes. Así podés obtener trazas de solicitudes HTTP sin modificar cada función.
Pero para medir una regla específica, como «validar disponibilidad de una reserva», quizá tenga sentido agregar instrumentación manual. Una traza útil combina datos de infraestructura con operaciones que tienen significado para el negocio.
¿Qué es el Collector?
El ecosistema incluye OpenTelemetry Collector, un componente que puede recibir, procesar y exportar señales de telemetría.
Puede resultar útil para centralizar el envío de información, aplicar transformaciones o dirigir datos hacia una plataforma de análisis compatible. Pero es otra pieza que hay que configurar, mantener y supervisar.
No confundas el Collector con una interfaz de visualización completa: normalmente los datos se consultan en un backend o herramienta especializada.
¿Qué ocurre con los logs?
Los logs ayudan a explicar eventos. Su relación con identificadores de traza facilita pasar de «la API devolvió un error» a «esta operación específica falló dentro de este servicio».
No todas las bibliotecas agregan contexto automáticamente y las capacidades pueden variar por lenguaje y versión. Es importante verificar qué instrumentación se implementó realmente.
Costes, privacidad y muestreo
Guardar todas las trazas de una aplicación muy concurrida puede consumir almacenamiento y ancho de banda. Existen estrategias de muestreo para conservar solo una parte, aunque eso significa que no siempre tendrás cada solicitud disponible.
Además, no deberías añadir contraseñas, tokens ni datos personales completos como atributos de telemetría. Una herramienta de observación puede convertirse en un riesgo si recibe secretos innecesarios.
Un ejemplo útil para diagnosticar un fallo
Después de actualizar una aplicación, la métrica de latencia aumenta. Una traza muestra que el backend tarda poco en procesar la solicitud, pero una llamada externa utiliza casi todo el tiempo.
En vez de comprar un VPS más potente por intuición, podés revisar el proveedor externo, su tiempo de respuesta y la política de timeout.
¿Cómo se relaciona con ArduMaker?
Si alojás varios servicios en VPS administrados desde ArduMaker, podés instrumentarlos con OpenTelemetry si sus frameworks son compatibles y enviar las señales a una herramienta de observación. El valor principal está en correlacionar el comportamiento entre aplicaciones, no en añadir más gráficos por decoración.
En resumen: OpenTelemetry estandariza parte de la producción y transporte de telemetría. Es útil para investigar sistemas distribuidos, siempre que instrumentes las operaciones correctas y protejas los datos recopilados.
Fuentes: Documentación de OpenTelemetry · Conceptos de trazas · Collector.