Un equipo añade el agente Java de OpenTelemetry a un servicio que ya vigila OneAgent. Resultado: cada petición aparece dos veces, una traza se corta en seco a mitad de la cadena de llamadas y nadie sabe ya qué tiempo de respuesta creer. Este caso de OneAgent y OpenTelemetry duplicados (spans repetidos, contexto roto) es frecuente, y se resuelve con una decisión de arquitectura sencilla: un solo propietario de la instrumentación por proceso.
Objetivo de este tutorial: identificar la causa de los spans repetidos o del contexto roto, elegir el modo de convivencia adecuado y verificar después que cada petición produce una sola traza completa. El contenido sirve para Dynatrace SaaS y Dynatrace Managed; las pantallas de análisis de trazas difieren, pero la lógica es la misma.
Para la visión de conjunto de una cadena instrumentada de extremo a extremo, lee también OpenTelemetry de extremo a extremo con Dynatrace.
OneAgent y OpenTelemetry duplicados: las tres causas
Casi siempre se repiten tres causas:
- Dos autoinstrumentaciones en el mismo proceso. OneAgent instrumenta la JVM (o el runtime .NET, Node.js…) y el agente de OpenTelemetry instrumenta las mismas bibliotecas HTTP y JDBC. Cada llamada produce dos spans, enviados por dos caminos distintos.
- Spans de OpenTelemetry capturados dos veces. OneAgent sabe capturar los spans creados con la API de OpenTelemetry en un proceso que monitoriza. Si además la aplicación exporta esos spans en OTLP hacia Dynatrace, llegan una vez por OneAgent y otra por OTLP.
- Propagación de contexto rota. El servicio A envía una cabecera
traceparent(W3C Trace Context) que el servicio B ignora, o un proxy elimina las cabeceras. B inicia una traza nueva: la cadena queda partida en dos.
Requisitos previos
- Un entorno Dynatrace SaaS o Managed con OneAgent en modo full-stack en los hosts o mediante Dynatrace Operator.
- Acceso de lectura a los ajustes del entorno (OneAgent features, monitorización de procesos).
- Para los servicios con OpenTelemetry: un token de API con el scope
openTelemetryTrace.ingesty un endpoint OTLP, directo o a través del Collector de OpenTelemetry. - Acceso a shell o a
kubectlen los procesos afectados.
Pasos para eliminar los duplicados de OneAgent y OpenTelemetry
Paso 1: inventariar quién instrumenta qué
En un host, enumera los agentes cargados en las JVM:
# Agents Java chargés au démarrage
ps -eo pid,args | grep -E 'javaagent|JAVA_TOOL_OPTIONS' | grep -v grep
# Variables OpenTelemetry d'un processus (remplacer 1234 par le PID)
tr '\0' '\n' < /proc/1234/environ | grep -E '^OTEL_|JAVA_TOOL_OPTIONS'
En Kubernetes, busca las dos posibles inyecciones en los pods:
kubectl get pod checkout-7d9f -n shop -o yaml \
| grep -E 'instrumentation.opentelemetry.io|oneagent.dynatrace.com|JAVA_TOOL_OPTIONS'
Si ves a la vez una inyección de OneAgent y la anotación instrumentation.opentelemetry.io/inject-java: "true" del operador de OpenTelemetry, el proceso tiene dos propietarios.
Paso 2: elegir un propietario por proceso
| Modo | Quién instrumenta | Cuándo elegirlo |
|---|---|---|
| A. OneAgent propietario | OneAgent; la API de OpenTelemetry solo sirve para spans de negocio manuales | Servicios ya monitorizados por OneAgent, equipo que quiere PurePath y profiling |
| B. OpenTelemetry propietario | SDK o agente de OpenTelemetry; OneAgent permanece en el host sin instrumentar ese proceso | Equipo que estandariza en OpenTelemetry, portabilidad entre herramientas |
| C. Mixto por servicio | A para algunos servicios, B para otros | Migración progresiva; exige propagación W3C de extremo a extremo |
Lo que nunca hay que hacer: dos autoinstrumentaciones activas en la misma JVM.
Paso 3a: modo A, OneAgent propietario
Retira el agente de OpenTelemetry del arranque y corta la exportación OTLP de trazas. Conserva la API de OpenTelemetry en el código si creas spans de negocio:
# Retirer -javaagent:opentelemetry-javaagent.jar de JAVA_TOOL_OPTIONS
# Si un SDK OpenTelemetry reste initialisé dans le code :
export OTEL_TRACES_EXPORTER=none
Comprueba después en los ajustes de OneAgent features que el OpenTelemetry Span Sensor del code module de OneAgent está activado para tu tecnología (disponible para Java, Go, Node.js, PHP y .NET). El nombre exacto de la opción varía según el lenguaje y la versión; busca «OpenTelemetry» en la lista y confírmalo en la documentación de OpenTelemetry de Dynatrace. Normalmente hace falta reiniciar el proceso.
Paso 3b: modo B, OpenTelemetry propietario
Impide que OneAgent instrumente el proceso, sin retirarlo del host. En Kubernetes con Dynatrace Operator, desactiva la inyección a nivel de pod:
apiVersion: apps/v1
kind: Deployment
metadata:
name: checkout
spec:
template:
metadata:
annotations:
oneagent.dynatrace.com/inject: "false"
instrumentation.opentelemetry.io/inject-java: "true"
En un host clásico, crea una regla de monitorización de procesos que excluya ese proceso de la monitorización profunda (Settings → Processes and containers, según tu versión). La métrica del host sigue recogiéndola OneAgent. El detalle del Operator está en Dynatrace Operator en Kubernetes.
Paso 4: reparar la propagación de contexto
En las cadenas mixtas, los dos mundos deben hablar W3C Trace Context. En el lado de OpenTelemetry, fija los propagadores de forma explícita:
export OTEL_PROPAGATORS=tracecontext,baggage
En el lado de OneAgent, comprueba en los ajustes de trazado distribuido que el envío de las cabeceras W3C Trace Context está activado (lo está por defecto en las versiones recientes; confírmalo en la tuya). Revisa también los proxies, API gateways y service meshes: deben transmitir traceparent y tracestate sin reescribirlos.
Cómo comprobar que funciona
Envía una petición de prueba con un traceparent conocido:
curl -s -o /dev/null -w '%{http_code}\n' \
-H 'traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01' \
https://checkout.example.internal/api/cart
En SaaS, busca esa traza en Grail:
fetch spans, from: now() - 15m
| filter trace.id == "4bf92f3577b34da6a3ce929d0e0e4736"
| summarize spans = count(), by: { dt.entity.service, span.name }
| sort spans desc
Resultado esperado: cada pareja servicio/operación aparece una vez por llamada real. Dos servicios distintos para el mismo proceso (por ejemplo, uno nombrado por OneAgent y otro por service.name) delatan una doble instrumentación. Los nombres de los campos pueden variar: compruébalos con fetch spans | limit 1. En Managed, abre la vista de trazas distribuidas, filtra por el servicio y comprueba que la traza contiene todos los servicios esperados, sin nodos duplicados.
Buenas prácticas
- Escribe la regla en tus estándares de plataforma: un proceso, un propietario de la instrumentación.
- Durante una migración, usa el mismo
service.nameque el nombre de servicio que ve OneAgent, para conservar la continuidad de los SLO. - Tras cada cambio, compara el número de peticiones antes y después: un volumen dividido por dos indica el fin de un duplicado, no una bajada de tráfico.
- Los duplicados también inflan el consumo de licencia y falsean los SLI: vigílalos como un riesgo de fiabilidad, consulta las alertas de burn rate de SLO.
Preguntas frecuentes
¿Puedo mantener OneAgent y la API de OpenTelemetry en el mismo servicio?
Sí, es el modo A. La API de OpenTelemetry sirve para crear spans de negocio; OneAgent los captura. El duplicado solo aparece si un exporter OTLP envía también esos spans.
¿Las métricas de OpenTelemetry también se duplican?
No se capturan con el mismo mecanismo que los spans. El riesgo principal es exportar dos veces la misma métrica por dos caminos (SDK y Collector, por ejemplo). Revisa tus pipelines de exportación.
¿El modo mixto degrada el análisis?
Funciona si la propagación W3C es completa. Algunos análisis propios de OneAgent, como el profiling de código, siguen ausentes en los servicios instrumentados solo con OpenTelemetry.
Conclusión
Los duplicados de OneAgent y OpenTelemetry no son un bug que sortear, sino el síntoma de dos instrumentaciones que compiten. Haz el inventario, elige un propietario por proceso, impón W3C Trace Context y verifica traza a traza. Tus SLI vuelven a ser fiables, y el análisis de incidentes también.
span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Comprueba siempre los valores (puertos, versiones, tamaños) en la documentación oficial correspondiente a tu versión. Las funciones evolucionan rápido: comprueba su disponibilidad en tu entorno y en la documentación oficial.