OneAgent y OpenTelemetry duplicados: evitar spans repetidos y contexto roto

OneAgent y OpenTelemetry duplicados: localiza la doble instrumentación, elige un propietario por proceso y repara la propagación W3C, paso a paso.
OneAgent OpenTelemetry doublons : éviter les spans en double et le contexte cassé

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:

  1. 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.
  2. 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.
  3. 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.ingest y un endpoint OTLP, directo o a través del Collector de OpenTelemetry.
  • Acceso a shell o a kubectl en 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.name que 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.

Total
0
Shares
Leave a Reply

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

Previous Post
Budget d'erreur release gate : bloquer une mise en production avec Dynatrace (SaaS et Managed)

Release gate de presupuesto de error: bloquear un paso a producción con Dynatrace (SaaS y Managed)

Next Post
Agent OpenTelemetry Java : instrumenter une application et l'envoyer à Dynatrace

Agente de OpenTelemetry para Java: instrumentar una aplicación y enviarla a Dynatrace

Related Posts