Un usuario dispara una factura, la API responde en 80 ms y un worker la genera cuarenta segundos después desde una cola. En la herramienta de trazas ves dos historias sin relación. La propagación de contexto asíncrono no ha tenido lugar: nadie escribió el contexto de traza en el mensaje y el worker inició una traza nueva.
Este tutorial está dirigido a equipos SRE y de plataforma que usan colas de mensajes (RabbitMQ, SQS, Redis, una tabla de jobs) o tareas en segundo plano. Explica qué debe viajar con el mensaje, cuándo elegir un enlace de span en lugar de un padre y cómo verificar el resultado. El caso particular de Kafka se detalla en la propagación de contexto de Kafka en Dynatrace; aquí el método vale para cualquier transporte. La ingesta OTLP se refiere a Dynatrace SaaS; las consultas DQL suponen Grail, es decir, un entorno SaaS.
Propagación de contexto asíncrono: el principio
En HTTP, el cliente escribe una cabecera traceparent y el servidor la lee. Según la documentación de OpenTelemetry, el contexto se «inyecta en el portador» (carrier) en el emisor y luego se «extrae» en el receptor. En un protocolo sin campo de metadatos dedicado, te corresponde elegir dónde guardar el contexto, y el receptor debe leerlo en el mismo lugar.
En una cola, el portador es lo que el mensaje ofrece: propiedades o cabeceras del mensaje, atributos de mensaje de SQS, un campo del cuerpo JSON, una columna de la tabla de jobs. El principio es el mismo: el productor inyecta, el consumidor extrae.
El formato por defecto de OpenTelemetry es W3C Trace Context. La variable OTEL_PROPAGATORS vale tracecontext,baggage por defecto en el SDK de Python (fuente: documentación de opentelemetry.propagate). Ambos lados deben usar el mismo formato.
Qué contiene la cabecera traceparent
La cabecera ocupa una línea de 55 caracteres en la versión 00: la versión, un identificador de traza de 32 caracteres hexadecimales, un identificador de span padre de 16 y, por último, las banderas. En la versión 00 solo se define la bandera sampled; es el último bit. Un identificador formado solo por ceros no es válido (especificación W3C).

El segundo recuadro resume las convenciones semánticas de mensajería: una operación create da un span PRODUCER, process un span CONSUMER, y receive y settle spans CLIENT.
Paso 1 — Inyectar el contexto al enviar
Crea un span de publicación y luego inyecta el contexto actual en un diccionario. Ese diccionario viaja con el mensaje. El código siguiente es genérico a propósito: queue.put representa la llamada de tu cliente.

Líneas críticas: propagate.inject(carrier) escribe traceparent (y tracestate si existe) a partir del contexto actual, es decir, del span PRODUCER abierto justo antes. Según las convenciones de OpenTelemetry, un productor «debería» adjuntar un contexto de creación a cada mensaje; sin él, las trazas del consumidor no pueden correlacionarse con las del productor.
Para Celery, SQS u otro cliente, comprueba primero si existe una instrumentación de OpenTelemetry para tu biblioteca: hace este trabajo sin código. Si no, la versión manual de arriba sigue siendo válida.
Paso 2 — Extraer el contexto en el worker
El worker lee el diccionario, llama a propagate.extract y obtiene un Context. Después hay dos opciones: convertirlo en el padre del span de procesamiento o crear un enlace de span hacia él.
Las convenciones de mensajería de OpenTelemetry presentan los enlaces como el mecanismo de correlación por defecto. Dan tres razones: los enlaces son la única estructura garantizada en todos los modelos de mensajería, la única opción para un lote (un span solo tiene un padre) y la única que funciona cuando el procesamiento ya se ejecuta en un contexto ambiental, como un span de servidor HTTP. Usar el contexto de creación como padre solo es válido para un mensaje único.

Líneas críticas: Link(span_context) toma el SpanContext del span que se quiere enlazar (firma Link(context, attributes=None)); start_as_current_span acepta los parámetros kind, links y context. Para obtener el padre en lugar de un enlace en un mensaje único, pasa context=ctx en lugar de links=.
Paso 3 — Gestionar lotes, reintentos y jobs programados
- Lotes: un solo span de procesamiento puede cubrir varios mensajes. Según las convenciones, enlaza entonces el contexto de creación de cada mensaje procesado. Dynatrace documenta un límite típico de 128 enlaces por span (límite de los SDK de OpenTelemetry, no impuesto por Dynatrace, según la página de ingesta de trazas): por encima, divide el lote.
- Mensajes precargados: no debe crearse un span de recepción para los mensajes que solo están en caché; aparece cuando el mensaje se entrega al código de la aplicación.
- Reintentos: un mensaje reproducido conserva el contexto original. La traza del reintento se asocia así a la solicitud inicial, a veces horas después. Es útil para el diagnóstico, pero la diferencia de tiempo alarga la traza.
- Jobs programados (cron): no existe contexto previo. Crea una raíz, es normal.
- Pasos intermedios: un enrutador, un puente o un conector que copia el mensaje debe copiar también el contexto. Prueba cada salto.
Paso 4 — Muestreo e ingesta
La bandera sampled viaja con el contexto. Con un muestreador que sigue al padre, el worker respeta la decisión tomada en la API; si el muestreo difiere en ambos lados, la traza queda mutilada. Para el muestreo en el Collector, consulta el tail sampling con OpenTelemetry y Dynatrace.
La exportación a Dynatrace sigue la vía OTLP habitual, detallada en el Collector de OpenTelemetry para Dynatrace. Si no llega nada, consulta primero el diagnóstico de trazas ausentes. Si OneAgent y OpenTelemetry instrumentan el mismo cliente, cuidado con los spans duplicados.
Cómo verificar que funciona
En Dynatrace SaaS, abre un Notebook. Esta consulta localiza las trazas que atraviesan al menos dos servicios para tu cola:
fetch spans, from: now() - 1h
| filter messaging.system == "rabbitmq"
| summarize services = collectDistinct(service.name), spans = count(), by: { trace.id }
| filter arraySize(services) >= 2
| limit 20
Para los procesamientos enlazados por enlace y no por padre, la traza del worker sigue siendo distinta: busca entonces spans que lleven enlaces, con filter isNotNull(span.links) (el campo span.links figura en el diccionario semántico de Dynatrace). Los nombres de campo y el valor de messaging.system dependen de tu instrumentación: contrólalos antes con fetch spans | limit 10. Si no sale nada aunque los dos servicios emitan, el contexto se pierde entre ambos. Este punto debe confirmarse en tu entorno: span.observer no ha ejecutado la consulta.
Buenas prácticas
- Un único formato de propagación en todas partes:
tracecontext. - Nombra los spans «<cola> publish» y «<cola> process» para facilitar la búsqueda.
- Mide el retraso entre publicación y procesamiento: es un SLI natural para un pipeline asíncrono, más elocuente que una latencia HTTP.
- Mantén el contexto fuera de los datos de negocio del mensaje: colócalo en un campo de metadatos dedicado, por ejemplo
trace_headers. - Evita los datos personales en
baggage: viaja con cada mensaje.
Preguntas frecuentes
¿Enlace de span o padre: qué elegir para un worker?
Para un lote, el enlace es la única opción. Para un mensaje único, el padre da una traza de una sola pieza, pero las convenciones de OpenTelemetry lo desaconsejan por defecto cuando el procesamiento ya se ejecuta dentro de otro span. En caso de duda, usa el enlace.
¿Sobrevive el contexto a un retraso de varias horas?
El contexto es simplemente una cadena de texto guardada con el mensaje: sobrevive mientras el mensaje exista. La traza, en cambio, depende de la retención y de los límites de ingesta. Dynatrace indica, por ejemplo, que un span no debe terminar más de 60 minutos en el pasado en el momento de la ingesta.
¿Hay que modificar el broker?
No. El broker transporta el mensaje tal cual. Solo el productor y el consumidor inyectan y extraen el contexto.
Conclusión
Inyectar al enviar, extraer al recibir, enlazar con un enlace en cuanto sea posible un lote: tres gestos bastan para que una solicitud y su procesamiento diferido sigan unidos. El equipo de guardia sigue entonces una factura desde la API hasta el worker sin correlacionar a mano, y el SLI del retraso de procesamiento pasa a ser calculable. Para la visión de conjunto, consulta OpenTelemetry de extremo a extremo. Fuentes oficiales: convenciones de mensajería de OpenTelemetry y especificación W3C Trace Context.
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.