Propagación de contexto asíncrono: colas de mensajes y jobs en segundo plano

Propagación de contexto asíncrono: inyecta traceparent en tus mensajes, enlaza worker y API con un enlace de span y verifica la traza en Dynatrace con DQL.
Propagation contexte asynchrone : files de messages et jobs en arrière-plan

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).

Formato de la cabecera traceparent de W3C con su ejemplo de la especificación, y tabla del tipo de span de OpenTelemetry según la operación de mensajería

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.

Código Python del productor: span PRODUCER, atributos messaging.system y messaging.destination.name, propagate.inject en un diccionario añadido al job

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.

Código Python del worker: propagate.extract en cada job, objetos Link, span CONSUMER creado con links para procesar un lote de mensajes

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.

Total
0
Shares
Leave a Reply

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

Previous Post
Seuil statique Dynatrace ou baseline : configurer la détection d'anomalies

Umbral estático Dynatrace o baseline: configurar la detección de anomalías

Next Post
Passerelle LLM : suivre les coûts avec LiteLLM et Helicone

Pasarela LLM: seguir los costes con LiteLLM y Helicone

Related Posts