Struct TraceContext

pub struct TraceContext { /* private fields */ }

Trace context that is propagated through HTTP headers to enable distributed tracing.

Currently still missing support for tracestate, otherwise compliant with https://www.w3.org/TR/trace-context-2/#design-overview, which standardizes how context information is sent and modified between services.

Implementations

impl TraceContext

pub fn new( trace_id: u128, span_id: u64, sampled: bool, state: Option<String>, ) -> Self

Construct a new trace context.

Version 0 of the trace context specification only supports the sampled flag, so we can offer a bool input for this flag.

pub fn new_sampled(trace_id: u128, span_id: u64, state: Option<String>) -> Self

Construct a new trace context with the sampled flag set to true.

pub fn new_unsampled( trace_id: u128, span_id: u64, state: Option<String>, ) -> Self

Construct a new trace context with the sampled flag set to false.

pub fn as_w3c_headers(&self) -> impl Iterator<Item = (&'static str, String)>

Render the context as w3c trace context headers.

https://www.w3.org/TR/trace-context-2

Trait Implementations

impl Clone for TraceContext

fn clone(&self) -> TraceContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Hash for TraceContext

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for TraceContext

fn eq(&self, other: &TraceContext) -> bool

Tests for self and other values to be equal, and is used by ==.

const fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for TraceContext

impl StructuralPartialEq for TraceContext