Demo OpenTelemetry Kubernetes: Helm y exportación OTLP a Dynatrace

Demo OpenTelemetry Kubernetes: instala Astronomy Shop con Helm, añade un exportador OTLP y envía sus trazas a Dynatrace SaaS para tus pruebas.
Démo OpenTelemetry Kubernetes : Helm et export OTLP vers Dynatrace

Es viernes por la tarde y el lunes toca desplegar un cambio en el Collector, o una consulta DQL nueva, sin haberla visto trabajar con tráfico de verdad. Apuntarla a producción es arriesgado, y generar peticiones a mano se come media jornada. Una demo OpenTelemetry Kubernetes resuelve justo eso: el proyecto mantiene «Astronomy Shop», una tienda ficticia hecha de microservicios, con su chart de Helm y un generador de carga incluido. Aquí sigo la página de despliegue en Kubernetes del proyecto y luego desvío parte de sus trazas hacia Dynatrace SaaS.

Lo útil es que separa dos preguntas que solemos mezclar: si tu pipeline transporta bien las trazas y si tus aplicaciones están bien instrumentadas. Aquí la instrumentación ya viene hecha, en doce lenguajes según la documentación (.NET, C++, Elixir, Go, Java, JavaScript, TypeScript, Kotlin, PHP, Python, Ruby y Rust). Solo queda poner a prueba el transporte.

Por transparencia: no he desplegado la demo para escribir esto. Los comandos y valores salen de la documentación de OpenTelemetry y de Dynatrace (consultada el 8 de noviembre de 2026) y del values.yaml del chart; lo que no he comprobado lo digo expresamente.

Cuándo conviene una demo OpenTelemetry Kubernetes

Sirve para tres cosas: probar un Collector, un exportador o un backend sin riesgo; aprender a leer trazas en un sistema ya instrumentado; y practicar diagnóstico con los indicadores de funcionalidad (feature flags), que provocan fallos preparados. No sirve para aprender a instrumentar tu propio código; para eso encaja mejor el artículo sobre el Operator y la autoinstrumentación.

Tampoco es gratis. La documentación pide Kubernetes 1.24 o superior, 6 GB de memoria libre y Helm 3.14 o superior, y el values.yaml que leí despliega además Kafka, OpenSearch y Jaeger. Reserva un clúster desechable o, como mínimo, un namespace propio.

Qué necesitas preparado en Dynatrace

Todo lo que sigue apunta a Dynatrace SaaS. No he leído ninguna página equivalente para Dynatrace Managed, así que no saco conclusiones para él. Necesitas un token de plataforma con el ámbito openpipeline:traces:ingest, enviado como Bearer en la cabecera Authorization, tal como indica la página de exportación OTLP. Créalo solo para esta prueba: lo borrarás al terminar.

Poner la tienda en marcha con dos comandos

La instalación básica casi no pide nada: se añade el repositorio de charts y se crea la release.

helm repo add open-telemetry https://open-telemetry.github.io/opentelemetry-helm-charts
helm install my-otel-demo open-telemetry/opentelemetry-demo

No queda nada expuesto al exterior. Para ver la tienda desde tu equipo, redirige el puerto del servicio frontend-proxy (cambia el namespace si no es default):

kubectl --namespace default port-forward svc/frontend-proxy 8080:8080

En ese puerto, la documentación sitúa la tienda en la raíz, el generador de carga en /loadgen/, Jaeger en /jaeger/ui/ y la interfaz de indicadores en /feature. Quédate con Jaeger: más adelante te servirá de referencia para comparar.

La trampa de los arrays en Helm antes de añadir un exportador

El Collector incluido se configura desde tu propio archivo de valores, bajo opentelemetry-collector y después config. Añadir un exportador ahí es sencillo; el problema está en cómo se combinan los valores. Helm fusiona los objetos, pero sustituye los arrays enteros. En cuanto escribes la lista exporters del pipeline traces, pisa la del chart: si no copias los exportadores originales, cortas Jaeger y las métricas derivadas de los spans sin que nada avise.

La página de la demo menciona que hay que conservar spanmetrics. Sin embargo, el values.yaml que leí (chart 0.42.6, aplicación 3.1.0, rama principal) nombra en ese pipeline otlp_grpc/jaeger, debug y span_metrics. Los nombres cambian entre versiones, así que antes de escribir nada ejecuta helm show values open-telemetry/opentelemetry-demo y copia la lista de la tuya.

Conectar Dynatrace sin dejar el token a la vista

Tres detalles de direccionamiento hacen perder tiempo. La URL base de SaaS es https://{id-entorno}.live.dynatrace.com/api/v2/otlp; si copias el identificador de la barra del navegador, quita .apps, porque la documentación avisa de que la dirección con .apps falla. El exportador otlphttp añade por su cuenta /v1/traces, así que dale solo la URL base. Y el transporte es HTTP con Protobuf: Dynatrace no recibe gRPC directamente.

Para que el token no acabe en el archivo de valores ni en Git, lo guardo en un Secret de Kubernetes que el Collector lee mediante variables de entorno (extraEnvs, que ofrece el chart del Collector). La sintaxis ${env:...} y la cabecera Bearer siguen el ejemplo de la página de Dynatrace sobre el despliegue del Collector. Este es el recorrido completo, con valores de ejemplo:

Terminal con la secuencia de instalación: helm repo add, kubectl create secret generic dynatrace-otlp con endpoint y token de ejemplo, helm install con --values dynatrace-values.yaml y kubectl port-forward del servicio frontend-proxy al puerto 8080

Y el archivo dynatrace-values.yaml que lo une todo:

Contenido de dynatrace-values.yaml: extraEnvs DT_ENDPOINT y DT_PLATFORM_TOKEN tomados de un Secret, exportador otlp_http/dynatrace con cabecera Authorization Bearer y lista exporters del pipeline traces con otlp_grpc/jaeger, debug, span_metrics y otlp_http/dynatrace

Esto es lo que reviso siempre en ese archivo:

  • la lista [otlp_grpc/jaeger, debug, span_metrics, otlp_http/dynatrace] es la original más una sola incorporación, así que Jaeger sigue recibiendo trazas;
  • el punto de entrada ${env:DT_ENDPOINT} termina en /api/v2/otlp;
  • el chart escribe otlp_http/... donde la página de la demo escribe otlphttp/...: respeta el estilo de tu versión del Collector. No he comprobado que ambas notaciones sean equivalentes.

Si la demo ya está en marcha, helm upgrade my-otel-demo open-telemetry/opentelemetry-demo --values dynatrace-values.yaml aplica el cambio (es un comando corriente de Helm, que no aparece en esa página). Hacia Dynatrace solo salen las trazas; las métricas y los logs siguen en sus backends de origen.

Comprobar que las trazas llegan

Espera a que los pods estén listos, abre la tienda y deja pasar unos minutos de carga sintética. Si en Dynatrace no aparece ninguna traza, empieza por los logs del pod del Collector (kubectl logs): un 401 o un 403 apunta al token o a su ámbito, y un 404 suele apuntar a la URL.

Después, en un Notebook, lanza una consulta DQL. Según la documentación, fetch spans da acceso a todos los spans y summarize los agrega. La plantilla siguiente se inspira en sus ejemplos; no la he ejecutado:

Consulta DQL sin ejecutar: fetch spans de los últimos 30 minutos, summarize con el número de spans por dt.service.name, orden descendente y límite de 20, y después fetch spans con limit 5 para inspeccionar los campos

El campo dt.service.name aparece en los ejemplos oficiales, pero no sé cómo se rellena en spans recibidos por OTLP. ¿Resultado vacío? Muestra cinco spans sin agrupar, mira sus campos y elige el que sirva para agrupar. Para llevar las consultas más lejos: DQL avanzado.

Recoger el banco de pruebas

La página de la demo no detalla la desinstalación. Con Helm, helm uninstall my-otel-demo elimina la release y kubectl delete secret dynatrace-otlp borra el Secret. Revoca después el token creado para la prueba: es el único rastro duradero de todo el experimento.

Lo que esta demo no demuestra

  • RUM: según Dynatrace, los datos de front-end de OpenTelemetry recibidos por OTLP no activan las funciones de RUM (sesiones de usuario, Core Web Vitals, Session Replay). No juzgues esas funciones con este banco.
  • Convivencia con OneAgent: en un clúster que ya monitoriza, los spans pueden duplicarse; consulta los spans duplicados.
  • Sin verificar aquí: el despliegue real, el consumo medido, la compatibilidad entre los dos nombres de exportador y cómo se rellena dt.service.name.

Buenas prácticas

  • Un clúster desechable o un namespace dedicado, que se elimina al terminar.
  • URL y token en un Secret, nunca en Git.
  • Token limitado a openpipeline:traces:ingest y revocado después.
  • Jaeger se mantiene en el pipeline para comparar con Dynatrace.
  • Siguiente paso realista: un Collector de Kubernetes hacia Dynatrace con cargas reales.

Preguntas frecuentes

¿Qué requisitos mínimos tiene la demo de OpenTelemetry en Kubernetes?

Según la documentación del proyecto, Kubernetes 1.24 o superior, 6 GB de memoria libre y Helm 3.14 o superior.

¿Se puede exportar a Dynatrace por gRPC?

No directamente: Dynatrace espera Protobuf sobre HTTP, no JSON. Si tus fuentes hablan gRPC, un Collector puede hacer la conversión antes del envío.

¿Y con Dynatrace Managed?

No lo he comprobado: este artículo se basa en la página de SaaS y en un token de plataforma. Para Managed, consulta las páginas /managed/ de la documentación.

Conclusión

Un archivo de valores, un Secret y un exportador bastan, según la documentación, para alimentar Dynatrace SaaS con el tráfico de una tienda de demostración sin perder Jaeger. Antes de escribir nada, comprueba la lista de exportadores de tu versión del chart: ahí es donde se rompe todo en silencio.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC ni al proyecto OpenTelemetry. Dynatrace es una marca de Dynatrace LLC; las demás marcas citadas pertenecen a sus propietarios. Comprueba siempre los valores (puertos, versiones, tamaños) y los comandos en la documentación oficial correspondiente a tu versión.

Total
0
Shares
Leave a Reply

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

Previous Post
Épuisement SNAT Azure : détecter et alerter avec Dynatrace

Agotamiento SNAT Azure: detectar y alertar con Dynatrace

Next Post
NetworkPolicy Kubernetes : isoler et tester les flux

NetworkPolicy Kubernetes: cómo aislar el tráfico entre pods

Related Posts