Struct TraceContextPropagator

pub struct TraceContextPropagator { /* private fields */ }

Propagates SpanContexts in W3C TraceContext format under traceparent and tracestate header.

The traceparent header represents the incoming request in a tracing system in a common format, understood by all vendors. Here’s an example of a traceparent header.

traceparent: 00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01

The traceparent HTTP header field identifies the incoming request in a tracing system. It has four fields:

• version
• trace-id
• parent-id
• trace-flags

The tracestate header provides additional vendor-specific trace identification information across different distributed tracing systems. Here’s an example of a tracestate header

tracestate: vendorname1=opaqueValue1,vendorname2=opaqueValue2

See the w3c trace-context docs for more details.

Implementations

impl TraceContextPropagator

pub fn new() -> Self

Create a new TraceContextPropagator.

Trait Implementations

impl Clone for TraceContextPropagator

fn clone(&self) -> TraceContextPropagator

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TraceContextPropagator

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for TraceContextPropagator

fn default() -> TraceContextPropagator

Returns the “default value” for a type.

impl TextMapPropagator for TraceContextPropagator

fn inject_context(&self, cx: &Context, injector: &mut dyn Injector)

Properly encodes the values of the SpanContext and injects them into the Injector.

fn extract_with_context( &self, cx: &Context, extractor: &dyn Extractor, ) -> Context

Retrieves encoded SpanContexts using the Extractor. It decodes the SpanContext and returns it. If no SpanContext was retrieved OR if the retrieved SpanContext is invalid then an empty SpanContext is returned.

fn fields(&self) -> FieldIter<'_>

Returns iter of fields used by TextMapPropagator

fn inject(&self, injector: &mut dyn Injector)

Properly encodes the values of the current Context and injects them into the Injector.

fn extract(&self, extractor: &dyn Extractor) -> Context

Retrieves encoded data using the provided Extractor. If no data for this format was retrieved OR if the retrieved data is invalid, then the current Context is returned.