Propagation du contexte des traces Java
Le traceur APM Datadog prend en charge l’extraction et l’injection des en-têtes B3 et des en-têtes de contexte de trace W3C pour le tracing distribué.
Vous pouvez configurer des styles d’injection et d’extraction pour les en-têtes distribués.
Le traceur Java prend en charge les styles suivants :
- Datadog :
datadog - En-tête B3 multiple :
b3multi (l’alias b3 est obsolète) - Contexte de trace W3C :
tracecontext (disponible depuis la version 1.11.0) - En-tête B3 unique :
b3 single header (b3single)
Les styles d’injection peuvent être configurés via :
- Une propriété système :
-Ddd.trace.propagation.style.inject=datadog,b3multi - Une variable d’environnement :
DD_TRACE_PROPAGATION_STYLE_INJECT=datadog,b3multi
La propriété ou la variable d’environnement prend pour valeur une liste de styles d’en-tête séparés par des virgules (ou des espaces) qui sont activés pour l’injection. Par défaut, les styles d’injection datadog,tracecontext sont activés.
Les styles d’extraction peuvent être configurés via :
- Une propriété système :
-Ddd.trace.propagation.style.extract=datadog,b3multi - Une variable d’environnement :
DD_TRACE_PROPAGATION_STYLE_EXTRACT=datadog,b3multi
La propriété ou la variable d’environnement prend pour valeur une liste de styles d’en-tête séparés par des virgules (ou des espaces) qui sont activés pour l’injection. Par défaut, les styles d’extraction datadog et tracecontext sont activés avec le paramètre datadog,tracecontext. Ainsi, le style datadog est prioritaire par rapport au style tracecontext.
Lorsque plusieurs styles d’extraction sont configurés, la tentative d’extraction est basée sur l’ordre de configuration des styles. La première valeur extraite est utilisée. Si des contextes de trace valides sont détectés par la suite, ils sont désactivés et ajoutés sous la forme de liens de span. De plus, si le style tracecontext est activé, W3C Tracestate est propagé tant que W3C Traceparent correspond au contexte extrait.
Pour obtenir plus de détails sur les paramètres de propagation de contexte et sur d’autres configurations, consultez la section Configurer la bibliothèque de tracing Java.
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles:
