Struct TraceContext 

pub struct TraceContext {
    pub trace_id: [u8; 16],
    pub span_id: [u8; 8],
    pub flags: u8,
}

A W3C Trace Context traceparent.

Fields

trace_id: [u8; 16]

16-byte trace identifier; never all zero.

span_id: [u8; 8]

8-byte span identifier of the sender’s span; never all zero.

flags: u8

Trace flags byte; bit 0 is sampled.

Implementations

impl TraceContext

pub const fn new( trace_id: [u8; 16], span_id: [u8; 8], flags: u8, ) -> Option<TraceContext>

Builds a context from raw identifiers.

Returns None if either identifier is all zero, which the W3C specification forbids.

pub fn parse_traceparent(value: &str) -> Result<TraceContext, TraceError>

Parses a traceparent header value.

Only version 00 layout is accepted: exactly 55 bytes, vv-<32 hex>-<16 hex>-<2 hex>, lowercase hex, version not ff, neither identifier all zero.

pub fn to_traceparent(&self) -> String

Formats the context as a version-00 traceparent value.

pub fn trace_id_hex(&self) -> String

The trace id as 32 lowercase hex digits, for log fields.

pub fn span_id_hex(&self) -> String

The span id as 16 lowercase hex digits, for log fields.

pub const fn is_sampled(&self) -> bool

True if the sampled flag is set.

pub const fn with_span_id(&self, span_id: [u8; 8]) -> Option<TraceContext>

Same trace, new span. Returns None for an all-zero span id.

Trait Implementations

impl Clone for TraceContext

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TraceContext

impl Debug for TraceContext

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

Formats the value using the given formatter.

impl Display for TraceContext

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

Formats the value using the given formatter.

impl Eq for TraceContext

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: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TraceContext