{"canonical_url":"https://engineer.company/es/glossary/opentelemetry/","content_markdown":"# OpenTelemetry\n\n## Qué es\n\nOpenTelemetry es un estándar de código abierto, con bibliotecas y herramientas\ncorrespondientes, para producir trazas, métricas y registros del software en\nejecución y entregarlos al sistema que los almacene y muestre. La mayoría de los\ningenieros lo llaman OTel. Es un proyecto de la Cloud Native Computing\nFoundation, nacido al fusionarse dos iniciativas anteriores, OpenTracing y\nOpenCensus.\n\nLo más útil que conviene saber es lo que deja fuera. OpenTelemetry no es un\nbackend de observabilidad: no conserva datos, no dibuja paneles ni envía\nalertas. Esa parte la hacen Jaeger, Prometheus y las plataformas comerciales.\nPor tanto, «¿OpenTelemetry o Prometheus?» compara un conducto con un destino, y\nla respuesta habitual es ambos: OpenTelemetry donde se producen los datos y un\nbackend elegido por el equipo donde se guardan.\n\nEl proyecto consta de varias piezas que encajan entre sí:\n\n- una **especificación** que define la API, el SDK y los datos para todos los\n  lenguajes;\n- **OTLP**, el protocolo que transporta telemetría por gRPC o HTTP, codificada\n  con Protocol Buffers;\n- **convenciones semánticas**, nombres compartidos para elementos compartidos,\n  de modo que una ruta HTTP o una sentencia de base de datos tenga la misma\n  etiqueta en Go, Java y Python;\n- una **API y un SDK por lenguaje**, con bibliotecas de instrumentación e\n  instrumentación automática para marcos populares;\n- el **Collector**, un proceso separado que recibe telemetría, la procesa y la\n  exporta hacia el siguiente destino.\n\nDe las señales que transporta, las trazas son las que más explicación necesitan.\nUna traza sigue una petición por todos los servicios que toca. Cada paso es un\nspan: un nombre, una hora de inicio, una duración, un conjunto de atributos y la\nidentidad del span que lo provocó. Cuando la petición pasa de un servicio al\nsiguiente, esa identidad viaja con ella en una cabecera, de forma predeterminada la que\ndefine W3C Trace Context:\n\n```text\ntraceparent: 00-a0892f3577b34da6a3ce929d0e0e4736-f03067aa0ba902b7-01\n```\n\nLos cuatro campos son la versión del formato, el ID de traza compartido por\ntodos los spans de la petición, el ID del span que hace la llamada y un conjunto\nde indicadores, donde un `01` final marca la traza como muestreada. Las métricas\ny los registros completan la imagen, y una cuarta señal, baggage, lleva pequeños\ndatos de clave y valor junto con la petición para que un servicio situado tres\nsaltos más allá aún pueda verlos.\n\n## Por qué importa\n\nEl almacenamiento es el coste visible de la observabilidad. El más persistente\nes la instrumentación: alguien tiene que añadir llamadas a cada servicio, en\ncada lenguaje, y mantenerlas al día conforme cambia el código. Cuando cada\nproveedor distribuía su propio agente y su propia API, cambiar de proveedor\nsignificaba repetir todo ese trabajo. Con OpenTelemetry, el código llama a una\nAPI, y la elección del backend pasa a la configuración, ya sea un exportador en\nel SDK o una ruta en el Collector. El proyecto enuncia directamente el\nprincipio: los datos que genera un sistema pertenecen a quien lo opera.\n\nEsa propiedad tiene efectos prácticos además de contractuales. El Collector se sitúa entre las\naplicaciones y el backend, lo que lo convierte en el lugar para filtrar,\nmuestrear, renombrar o eliminar atributos antes de que salga nada y para enviar\nel mismo flujo a dos backends mientras se realiza una migración. Pasar de un\nproveedor a otro se convierte en un cambio de configuración del Collector en vez\nde en cien servicios.\n\nEl volumen es el coste que hay que planificar. Cada petición puede producir\ndecenas de spans, y con tráfico real la factura de conservarlos todos puede\nsuperar la del servicio observado. El muestreador predeterminado del SDK, `ParentBased(root=AlwaysOn)`,\nmuestrea cada traza nueva y sigue la decisión de quien llama para el resto, por\nlo que, tal como viene configurado, se conserva todo. Cuánto conservar es una\ndecisión que el equipo toma deliberadamente.\n\nLa madurez varía según la señal y el lenguaje. OTLP es estable para trazas,\nmétricas y registros, mientras que el SDK de cada lenguaje avanza a su propio\nritmo, y la página de estado del proyecto indica dónde está cada uno. Léala\nantes de decidirse por él para un servicio escrito en un lenguaje menos\nhabitual.\n\nY no siempre compensa. Una sola aplicación con registros estructurados y unas\npocas métricas gana poco con el trazado distribuido. OpenTelemetry justifica su\ncoste cuando una petición cruza límites entre procesos, pasando por un frontend,\nuna API, una cola y una base de datos, y responder a «¿en qué se fue el tiempo?»\nrequiere una reunión.\n\n## Cómo se aplica en la práctica\n\nEn una plataforma, la monitorización se construyó en lugar de comprarse, y\nOpenTelemetry es su mitad de trazado. [El trazado utiliza OTLP para seguir una petición lenta por el frontend, la API y la base de datos](/es/portfolio/built-first-party-error-monitoring-and-tracing/) en lugar de hacer conjeturas. Junto a\nél funciona un flujo de procesamiento de errores propio, compuesto por un\nservicio errmon y otro de ingestión, que sanea las cargas útiles antes de\nalmacenarlas, agrupa errores en problemas recurrentes, detecta picos y\nregresiones con un período de espera para que un despliegue defectuoso no envíe\ncuarenta avisos a la persona de guardia, resuelve los símbolos de las trazas de pila\nminificadas del frontend y ejecuta un latido sintético para demostrar que el\npropio flujo de procesamiento sigue vivo.\n\nLos resultados llegan a la propia base de datos de la plataforma como eventos de\nerror, grupos de errores, una bandeja de entrada, latencia de API y muestras de\npilas. Los operadores trabajan con 11 vistas sobre esos datos, una de ellas\ndedicada a objetivos de nivel de servicio. La página es clara sobre el precio:\nconstruirlo requirió una inversión real de tiempo y añadió otro elemento que\nmantener, mientras que una herramienta comprada de seguimiento de errores habría\nestado funcionando aquella misma tarde. A cambio, los datos sensibles permanecen\nen la plataforma. También las reglas de alerta se escribieron para esta\nplataforma en vez de para una genérica.\n\n## Dónde surgen los problemas\n\n**La traza se detiene en un límite.** El contexto cruza fácilmente las llamadas\nHTTP porque las bibliotecas de instrumentación escriben y leen la cabecera en\nambos extremos. Una cola de mensajes, una tarea programada o un proxy que\nelimine cabeceras desconocidas rompe la cadena salvo que alguien transporte el\ncontexto a mano. La traza se divide en dos, y la mitad lenta parece no guardar\nrelación con la petición que la causó. Incluya el contexto en los metadatos del\nmensaje y compruebe que todos los servicios ejecuten el mismo propagador.\n\n**Los atributos filtran información o se multiplican sin control.** Es fácil\nañadir un atributo de span, y los valores más fáciles de añadir son los\nequivocados: correos electrónicos, URL completas con tokens en la cadena de\nconsulta o SQL que aún contiene valores literales. En las métricas, el peligro\nes la cardinalidad. Un atributo con millones de valores distintos, como un ID de\nusuario, multiplica el número de series temporales y, con él, la factura. Siga\nlas convenciones semánticas, mantenga los identificadores fuera de las métricas\ny oculte los datos sensibles en el Collector como segunda línea de defensa.\n\n**El muestreo ocurre por accidente.** El muestreo al inicio decide al comienzo\nde una petición, antes de saber si será lenta o fallará, por lo que conservar el\n1 % de las trazas también conserva aproximadamente el 1 % de las escasas trazas\nlentas. El muestreo al final decide después de ver juntos los spans de una traza\ny puede conservar todos los errores y todas las peticiones lentas, pero el\ncomponente que lo realiza debe mantener todos esos datos mientras espera. Es un\nservicio con estado cuya propia capacidad hay que planificar y vigilar.\n\n**Se confía ciegamente en el flujo de procesamiento.** OTLP confirma la entrega\nsalto a salto; la entrega de extremo a extremo queda fuera de su alcance. Un\nCollector que no dispone de memoria suficiente o se retrasa en su cola de\nexportación descarta telemetría, y las aplicaciones que se la envían continúan\ncomo si todo fuera bien. Vigile las propias métricas del Collector, ejecute más\nde uno y trate un hueco en las trazas como un fallo que explicar en lugar de\ncomo una hora tranquila.\n\n## Lecturas adicionales\n\n- [¿Qué es OpenTelemetry?](https://opentelemetry.io/docs/what-is-opentelemetry/)\n  — definición del propio proyecto, sus componentes y lo que deliberadamente no\n  es.\n- [Especificación OTLP](https://opentelemetry.io/docs/specs/otlp/)\n  — protocolo de transmisión: transportes, codificación, compresión y\n  confirmación de recepción.\n- [Trace Context](https://www.w3.org/TR/trace-context/)\n  — recomendación del W3C en la que se basa la cabecera `traceparent`.\n- [Propagación de contexto](https://opentelemetry.io/docs/concepts/context-propagation/)\n  — cómo sigue una traza una petición a través de límites entre procesos.\n- [Convenciones semánticas](https://opentelemetry.io/docs/concepts/semantic-conventions/)\n  — nombres compartidos para atributos, métricas y recursos.\n- [Muestreo](https://opentelemetry.io/docs/concepts/sampling/)\n  — muestreo al inicio y al final, y el coste de ejecutar cada uno.\n\n\u003chttps://engineer.company/es/glossary/opentelemetry/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Cómo instrumenta OpenTelemetry el código una sola vez para distintos backends, qué hacen OTLP y Collector y dónde se atascan los proyectos de trazado.","formats":{"gemtext":"https://engineer.company/es/glossary/opentelemetry/index.gmi","gopher":"https://engineer.company/es/glossary/opentelemetry/gophermap","html":"https://engineer.company/es/glossary/opentelemetry/","json":"https://engineer.company/es/glossary/opentelemetry/index.json","markdown":"https://engineer.company/es/glossary/opentelemetry/index.md","pdf":"https://engineer.company/es/glossary/opentelemetry/index.pdf"},"kind":"page","language":"es","title":"¿Qué es OpenTelemetry?","url":"https://engineer.company/es/glossary/opentelemetry/","version":1}