Struct opentelemetry::api::context::propagation::composite_propagator::HttpTextCompositePropagator

pub struct HttpTextCompositePropagator { /* fields omitted */ }

A propagator that chains multiple HttpTextFormat propagators together, injecting or extracting by their respective HTTP header names.

Injection and extraction from this propagator will preserve the order of the injectors and extractors passed in during initialization.

Examples

use opentelemetry::api::*;
use opentelemetry::sdk;
use std::collections::HashMap;

// First create 1 or more propagators
let b3_propagator = B3Propagator::new(true);
let trace_context_propagator = TraceContextPropagator::new();

// Then create a composite propagator
let composite_propagator = HttpTextCompositePropagator::new(vec![
    Box::new(b3_propagator),
    Box::new(trace_context_propagator),
]);

// Then for a given implementation of `Carrier`
let mut carrier = HashMap::new();

// And a given span
let example_span = sdk::Provider::default().get_tracer("example-component").start("span-name");

// with the current context, call inject to add the headers
composite_propagator.inject_context(&Context::current_with_span(example_span), &mut carrier);

// The carrier now has both `X-B3` and `traceparent` headers
assert!(carrier.get("X-B3").is_some());
assert!(carrier.get("traceparent").is_some());

Implementations

impl HttpTextCompositePropagator

pub fn new(propagators: Vec<Box<dyn HttpTextFormat + Send + Sync>>) -> Self

Constructs a new propagator out of instances of HttpTextFormat.

Trait Implementations

impl Debug for HttpTextCompositePropagator

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

Formats the value using the given formatter.

impl HttpTextFormat for HttpTextCompositePropagator

fn inject_context(&self, context: &Context, carrier: &mut dyn Carrier)

Encodes the values of the Context and injects them into the Carrier.

fn extract_with_context(&self, cx: &Context, carrier: &dyn Carrier) -> Context

Retrieves encoded Context information using the Carrier. If no data was retrieved OR if the retrieved data is invalid, then the current Context is returned.

fn inject(&self, carrier: &mut dyn Carrier)

Properly encodes the values of the current [Context] and injects them into the [Carrier].

fn extract(&self, carrier: &dyn Carrier) -> Context

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