Dynatrace OTel Collector: migrar desde Contrib sin sorpresas

Dynatrace OTel Collector: qué quita la distribución respecto a Contrib, qué garantiza y cinco pasos para migrar sin romper tus pipelines.
Dynatrace OTel Collector : migrer de Contrib sans mauvaise surprise

Tu Collector funciona con la imagen Contrib y alguien te pide que lo cambies por el Dynatrace OTel Collector. Antes de tocar una sola línea conviene hacerse una pregunta: ¿qué cambia de verdad? Aquí no repasamos Contrib, que ya tiene su propia guía de componentes Contrib. Nos centramos en la diferencia entre ambos builds y en el camino de migración.

Qué he leído: la página de introducción y la de despliegue de la documentación de Dynatrace, y el README del repositorio de GitHub, el 9 de noviembre de 2026. Las versiones citadas son las de esas páginas en esa fecha. No he ejecutado el binario, así que todo lo relativo al comportamiento en ejecución queda marcado como sin verificar.

Dynatrace OTel Collector: un subconjunto elegido, no un fork

La documentación es clara: la distribución mantiene el modelo de configuración estándar y la semántica de los componentes, sin capas propietarias ni valores por defecto ocultos. Un YAML escrito para Contrib se sigue leyendo igual. Lo que cambia es lo que se compila dentro del binario.

Contrib incluye una enorme cantidad de receptores, procesadores y exportadores de terceros. La página de Dynatrace lo desaconseja en producción y lo reserva para pruebas, porque gasta más almacenamiento y memoria que un build a medida. La distribución de Dynatrace solo trae componentes que el fabricante dice haber verificado para los usos habituales. La lista completa está en el repositorio de GitHub, no en la documentación.

Lo que la distribución quita: lee la lista antes de cambiar

El riesgo de la migración está aquí. Si falta un componente en el binario, el arranque falla: el Collector rechaza una configuración que nombra un componente desconocido. Esto es lo que anoté de la sección Components del README.

Lista reformateada de receptores, procesadores y exportadores de la sección Components del README del repositorio Dynatrace OTel Collector, con los componentes alfa señalados
Source : github.com
  • Receptores: otlp, filelog, hostmetrics, prometheus, statsd, syslog, fluentforward, jaeger, zipkin, kafka, kafka_metrics y cuatro receptores de Kubernetes (k8sobjects, k8scluster, kubelet_stats, k8sevents). Journald y netflow están en alfa.
  • Procesadores: batch, memory_limiter, attributes, resource, resource_detection, transform, k8sattributes, cumulativetodelta, metricstarttime, probabilistic_sampler, tail_sampling y groupbytrace, además de filter, redaction y genainormalizer en alfa.
  • Exportadores: otlp, otlphttp, debug y kafka, más load_balancing en alfa.
  • Extensiones y conectores: bearertokenauth, oidcauth, healthcheck, zpages, k8sleaderelector y filestorage; forward y, en alfa, spanmetrics.

En esa lista no encuentro un exportador Prometheus Remote Write, un exportador de archivos, un receptor SQL ni un receptor Docker. Si tus pipelines dependen de alguno, necesitarás otra vía. La ausencia sale de mi lectura del README: no he compilado el binario para confirmarla.

Qué ofrece la distribución a cambio

No añade funciones ocultas. Añade garantías alrededor del binario.

  • Soporte del fabricante con límites: los builds x86-64 y ARM64 están cubiertos por el soporte de Dynatrace. Cada versión menor lo está durante tres meses, con parches sobre la última menor soportada o en la siguiente menor.
  • Parches de seguridad independientes: Dynatrace dice recibirlos sin esperar a las versiones del Collector upstream.
  • Imágenes firmadas: con cosign desde la versión 0.49.0, y publicadas en GHCR, Amazon ECR Public y Docker Hub.
  • Soporte limitado para lo demás: de Contrib, Dynatrace solo cubre los componentes y versiones presentes en su distribución. Las incidencias en GitHub se atienden como buenamente se pueda, sin contrato ni SLA.

La cuenta es un intercambio: menos componentes a cambio de un perímetro con soporte. Para un equipo SRE significa también menos superficie que parchear, y por tanto menos toil con cada CVE.

Migrar desde Contrib en cinco pasos

Este es el recorrido que seguiría yo. Parte de tu configuración real, no de la documentación.

  1. Inventaria los componentes en uso. Con yq (versión 4), lista lo que nombran tus pipelines y después las extensiones:
yq '.service.pipelines[] | .receivers[], .processors[], .exporters[]' config.yaml \
  | sed 's#/.*##' | sort -u
yq '.service.extensions[]' config.yaml | sed 's#/.*##' | sort -u
  1. Compáralos con la lista del repositorio. Cada componente que falte cae en uno de tres casos: se elimina, se sustituye, o se queda en un segundo Collector Contrib u OCB aguas arriba.
  2. Conecta el exportador de Dynatrace. La página de despliegue da este ejemplo, con la dirección y el token leídos del entorno:
Ejemplo de config.yaml mínimo: receptor OTLP, procesadores memory_limiter y batch, exportador otlp_http con DT_ENDPOINT y DT_PLATFORM_TOKEN y un pipeline de trazas
Source : docs.dynatrace.com
  1. Cambia la imagen o el paquete. La página de despliegue apunta a la versión 0.60.0 (dynatrace/dynatrace-otel-collector:0.60.0 en Docker Hub). Fija una versión concreta en lugar de latest.
  2. Cambia de forma gradual. Empieza por un Collector en modo pasarela, compara y luego extiende a los agentes.

Un detalle que probar: el ejemplo de la documentación llama al exportador otlp_http, mientras que muchas configuraciones de Contrib escriben otlphttp. No sé si la versión 0.60.0 acepta ambos nombres. Ejecuta la validación antes de generalizar.

Cómo comprobar que funciona

Primero valida el archivo y después mira las señales. Para el primer paso basta un comando:

./dynatrace-otel-collector validate --config=config.yaml

Este subcomando existe en el Collector upstream, pero no lo he probado con este binario. Detecta los componentes desconocidos antes de desplegar. Después, en la parte operativa:

  • Añade temporalmente el exportador debug para ver pasar los datos.
  • Activa la extensión healthcheck: los ejemplos de Helm de la documentación la exponen en el puerto 13133.
  • Compara el volumen recibido y el exportado antes y después, señal por señal.
  • En Dynatrace, comprueba que las trazas llegan, por ejemplo con los atributos que describe la anatomía de un span de OpenTelemetry.

Desplegar: tres vías en Kubernetes

La página de despliegue distingue el modo agente (un Collector junto a la aplicación) del modo pasarela (un servicio independiente, a menudo uno por clúster). En Kubernetes hay tres vías:

Las credenciales van en un secreto de Kubernetes, dynatrace-otelcol-dt-api-credentials en los ejemplos, con DT_ENDPOINT y DT_PLATFORM_TOKEN. Los ejemplos limitan la memoria a 512 Mi: ajústala a tu carga. Fuera de Kubernetes, la documentación contempla también Docker, binarios y paquetes DEB y RPM.

Managed o SaaS: lo que no pude confirmar

Los ejemplos que leí usan un token de plataforma, propio de un entorno SaaS. No he comprobado qué direcciones y tokens corresponden a un Dynatrace Managed. En Managed, parte de nuestro paso a paso sobre el Collector y Dynatrace y valida la dirección de ingesta en tu clúster. Los scopes exactos del token tampoco aparecen en las páginas que leí.

Buenas prácticas

  • Versiona la lista de componentes usados junto a la configuración: te sirve de control en cada actualización.
  • Planifica una actualización menor por trimestre: el soporte de una menor dura tres meses.
  • Trata los componentes alfa como inestables: la documentación del repositorio dice que pueden cambiar mucho.
  • Mantén un segundo Collector encadenado para las fuentes exóticas en vez de renunciar a la distribución con soporte.
  • No pongas nunca el token en el archivo: usa una variable de entorno o un secreto.

Preguntas frecuentes

¿Es compatible el Dynatrace OTel Collector con una configuración de Contrib?

Sí en cuanto al formato: la documentación afirma que el modelo de configuración sigue siendo el estándar. No en cuanto a los componentes que faltan en el binario, que impiden el arranque. Revisa la lista antes de cambiar.

¿Se pueden enviar datos a Dynatrace con Contrib?

Sí, el protocolo es OTLP en ambos casos. La diferencia está en el soporte: para Contrib se limita a los componentes y versiones incluidos en la distribución de Dynatrace.

¿Qué hago si falta un componente?

Construye un Collector a medida con el OpenTelemetry Collector Builder, o encadena dos Collectors: el propio para la fuente exótica y la distribución de Dynatrace como salida hacia la plataforma.

Conclusión

El Dynatrace OTel Collector no cambia cómo escribes una configuración. Cambia lo que acepta el binario y lo que el fabricante acepta soportar. Inventaría tus componentes, compáralos con la lista del repositorio y cambia un Collector cada vez. La ganancia se mide en menos superficie y parches más rápidos.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Las marcas citadas pertenecen a sus propietarios. Las herramientas evolucionan rápido: comprueba versiones, componentes y comandos en la documentación oficial y en el repositorio de GitHub.

Total
0
Shares
Leave a Reply

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

Previous Post
Vibe coding observabilité : que vérifier avant la prod

Vibe coding observabilidad: qué exigir antes de producción

Next Post
AI Observer assistants de code : coûts et traces en local

AI Observer asistentes de código: costes y trazas en local

Related Posts