OTLP APM Server o EDOT Collector: qué camino elegir

OTLP APM Server o EDOT Collector: árbol de decisión, endpoints, puertos y errores habituales para enviar datos de OpenTelemetry a Elastic sin fallos.
OTLP APM Server ou EDOT Collector : quel chemin choisir

La elección entre OTLP APM Server y EDOT Collector surge en cuanto quieres enviar tus datos de OpenTelemetry a Elastic: ¿conviene apuntar las aplicaciones al intake OTLP de APM Server o pasar por un EDOT Collector? Esta guía de decisión explica los dos caminos, los endpoints que hay que conocer, los errores habituales y lo que recomienda la documentación de Elastic. No trata de Dynatrace Managed ni SaaS: es un tema de Elastic, abordado desde el punto de vista de un equipo SRE o de plataforma que estandariza en OpenTelemetry. Páginas oficiales consultadas el 30 de octubre de 2026.

La elección importa porque fija el formato de almacenamiento (OTel nativo o traducido a ECS), los SDK utilizables y la facilidad de migrar más adelante.

OTLP APM Server o EDOT Collector: el resumen

  • Para un proyecto nuevo, la documentación de Elastic recomienda enviar a Elastic Agent o al Managed OTLP endpoint, «instead of to the APM Server» (en lugar de a APM Server).
  • El intake OTLP de APM Server se presenta como un camino heredado («legacy»): los datos se traducen a ECS antes de almacenarse.
  • Los SDK de EDOT no son compatibles con este intake, según la página de limitaciones.
  • El protocolo no cambia: es el mismo OTLP, por gRPC (puerto 4317 por defecto) o por HTTP (puerto 4318 por defecto).

Qué hace cada camino

Intake OTLP de APM Server

APM Server acepta OTLP/gRPC y OTLP/HTTP en el mismo puerto que los agentes APM de Elastic, según la documentación. Tus aplicaciones, o cualquier Collector de OpenTelemetry, envían directamente a ese puerto. La ventaja es la sencillez: ningún componente adicional si ya tienes un APM Server.

EDOT Collector y Elastic Agent

EDOT (Elastic Distribution of OpenTelemetry) agrupa distribuciones de OpenTelemetry adaptadas a Elastic: un Collector y varios SDK de lenguaje. Según la documentación, desde Elastic Agent 9.2 el Collector de OpenTelemetry se ejecuta dentro de Elastic Agent y comparte su archivo de configuración: ya no hace falta un binario aparte. En Elastic Cloud Serverless no existe APM Server: unos managed inputs reciben y transforman los datos.

Managed OTLP endpoint

En Serverless y Elastic Cloud Hosted, este punto de entrada almacena los datos en formato OTel nativo. Evita la traducción a ECS, lo que cambia los dashboards y las consultas disponibles.

Árbol de decisión

  1. ¿Estás en Elastic Cloud Serverless? No hay APM Server. Usa el Managed OTLP endpoint o Elastic Agent.
  2. ¿Usas los SDK de EDOT? Evita el intake de APM Server: no son compatibles con él. Apunta a Elastic Agent o al Managed OTLP endpoint.
  3. ¿Empiezas un despliegue nuevo? Sigue la recomendación de Elastic: Elastic Agent (con Collector integrado) o Managed OTLP endpoint.
  4. ¿Tienes un parque existente de agentes Elastic APM y de APM Server? El intake OTLP sigue siendo posible, con sus límites. Planifica la migración en lugar de ampliarlo.
  5. ¿Quieres mantener el control del enrutamiento? Coloca un Collector (gateway) delante del backend, como en el artículo sobre el Collector de OpenTelemetry en Kubernetes.

Los endpoints y los errores habituales

La especificación OTLP fija los valores por defecto: 4317 para gRPC, 4318 para HTTP y tres rutas para HTTP.

Puertos por defecto de OTLP 4317 (gRPC) y 4318 (HTTP) y rutas HTTP /v1/traces, /v1/metrics y /v1/logs

Varios errores se repiten en la documentación de Elastic:

  • Un solo puerto, dos protocolos. En APM Server, gRPC y HTTP comparten el puerto. Las solicitudes gRPC exigen HTTP/2 (TLS o H2C). Un balanceador de carga de nivel 7 puede no gestionar ambos: Elastic prefiere un balanceador L4 TCP, como un AWS NLB. Detrás de un proxy, OTLP/HTTP es más sencillo.
  • Solo protobuf. OTLP/HTTP solo acepta protobuf, no JSON.
  • Las rutas. Con un exportador HTTP, un SDK añade /v1/traces, /v1/metrics y /v1/logs a la URL base. Las páginas de Elastic consultadas no detallan estas rutas para APM Server: compruébalas en la página de APM Server de tu versión antes de fijarlas en el código.
  • Los logs. El intake OTLP de logs está en technical preview en APM Server, con el mapeo dinámico desactivado en el flujo de datos.
  • Ingress NGINX. Hace falta el exportador otlp con la anotación de protocolo gRPC, o otlphttp con la anotación HTTP.

Ejemplo: un Collector en gateway hacia Elastic

Este es un extracto de la configuración Gateway de la documentación de EDOT Collector: recibe OTLP en los dos puertos y exporta en modo OTel nativo.

Configuración del EDOT Collector: receptor otlp en 4317 y 4318, exportador elasticsearch/otel en modo otel

Dos líneas importan. mapping: mode: otel conserva el modelo de OpenTelemetry. La documentación describe también un exportador elasticsearch/ecs para el formato ECS (no incluido aquí). Las variables ELASTIC_ENDPOINT y ELASTIC_API_KEY son valores tuyos: nunca las escribas en claro en un repositorio.

Qué pierdes con el intake de APM Server

La página de limitaciones de Elastic enumera las contrapartidas del camino heredado.

Extractos de la página Limitaciones de Elastic: SDK de EDOT no compatibles, traducción a ECS, logs en technical preview, solo protobuf

Para un SRE pesan dos puntos: los atributos sin mapear pasan a labels.*, lo que complica las consultas, y los paquetes de contenido de OpenTelemetry no funcionan con los datos traducidos. El mismo documento señala que el tail sampling en el Collector puede falsear las métricas de rendimiento: consulta nuestro artículo sobre el tail sampling de OpenTelemetry.

Cómo comprobar que funciona

  1. En los logs del Collector o de Elastic Agent, busca errores de exportación o de recepción (401, 403, conexión rechazada).
  2. Envía una traza de prueba desde una aplicación y comprueba que aparece en Observability, con el nombre de servicio correcto.
  3. Compara una consulta sobre un atributo personalizado: en OTel nativo conserva su nombre; en ECS traducido puede acabar en labels.*.
  4. Detrás de un balanceador de carga, prueba gRPC y HTTP por separado.

Buenas prácticas

  • Estandariza en OTLP del lado de las aplicaciones: la elección del backend sigue siendo reversible. Consulta OpenTelemetry y Prometheus para la lógica de un estándar común.
  • Coloca un Collector entre tus aplicaciones y el backend, para cambiar de destino sin volver a desplegar los servicios.
  • Anota la versión de Elastic Agent o de APM Server que uses: la documentación evoluciona (la página de EDOT lista Elastic Agent 9.5.5 a 30 de octubre de 2026).
  • Vincula esta elección a tu SLO de calidad de datos: las trazas perdidas o mal mapeadas aumentan el MTTR.

Preguntas frecuentes

¿Está obsoleto el OTLP directo a APM Server?

La documentación de Elastic lo califica de «legacy» y lo desaconseja a los usuarios nuevos. No dice que deje de funcionar, pero documenta sus límites.

¿Puedo usar un SDK estándar de OpenTelemetry con APM Server?

Sí, el intake acepta OTLP. Son los SDK de EDOT los que no son compatibles con este intake, según Elastic.

¿Hace falta un Collector aparte con Elastic Agent?

No, desde Elastic Agent 9.2 según la documentación: el Collector se ejecuta dentro del agente y comparte su configuración. Un Collector aparte sigue siendo útil para el enrutamiento a varios backends, por ejemplo hacia varias herramientas.

Conclusión

Para un despliegue nuevo, sigue la recomendación de Elastic: Elastic Agent o Managed OTLP endpoint. Reserva el intake OTLP de APM Server para un parque existente, conociendo sus límites. Fuentes: documentación de OpenTelemetry de Elastic, referencia de EDOT.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC ni a Elastic N.V. La información de Elastic procede de su documentación pública, consultada el 30 de octubre de 2026; compruébala para tu versión.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
DDOT Datadog : le collecteur OpenTelemetry installé avec l'Agent

DDOT Datadog: el Collector de OpenTelemetry que se instala con el Agent

Next Post
Elasticsearch OpenTelemetry monitoring : le collecteur pas à pas

Monitorización de Elasticsearch con OpenTelemetry: el Collector paso a paso

Related Posts