Struct TraceContext

pub struct TraceContext { /* private fields */ }

A TraceContext represents a distributed trace request.

It consists of a trace ID, the ID of the parent span, the ID of the context’s span, and flags dealing with the sampling of the span.

The trace context is sent to remote services on requests. For example, it is included in a standard set of headers in HTTP requests.

Implementations

impl TraceContext

pub fn builder() -> Builder

Returns a builder used to construct a TraceContext.

pub fn trace_id(&self) -> TraceId

Returns the ID of the trace associated with this context.

pub fn parent_id(&self) -> Option<SpanId>

Returns the ID of the parent of the span associated with this context.

pub fn span_id(&self) -> SpanId

Returns the ID of the span associated with this context.

pub fn sampling_flags(&self) -> SamplingFlags

Returns the sampling flags associated with this context.

pub fn sampled(&self) -> Option<bool>

Determines if sampling has been requested for this context.

A value of None indicates that the service working in the context is responsible for determining if it should be sampled.

pub fn debug(&self) -> bool

Determines if this context is in debug mode.

Debug contexts should always be sampled, regardless of the value of sampled().

Trait Implementations

impl Clone for TraceContext

fn clone(&self) -> TraceContext

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TraceContext

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

Formats the value using the given formatter.

impl From<TraceContext> for Builder

fn from(c: TraceContext) -> Builder

Converts to this type from the input type.

impl PartialEq for TraceContext

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

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

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 Copy for TraceContext

impl Eq for TraceContext

impl StructuralPartialEq for TraceContext