Struct TraceContext 

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

Distributed-tracing identity for one server hop.

Fields

trace_id: [u8; 16]

Preserved across the entire distributed call chain.

span_id: [u8; 8]

This hop’s freshly-minted span ID.

parent_span_id: [u8; 8]

The upstream caller’s span ID (all-zeros = this hop is the root).

Implementations

impl TraceContext

pub fn to_traceparent(&self) -> String

W3C traceparent string for embedding in non-HTTP envelopes (outbox rows, queue messages) — 00-{trace}-{span}-01 where the span field is THIS hop’s span (the consumer’s parent).

pub fn from_traceparent(s: &str) -> Option<TraceContext>

Continue a trace carried in a message envelope: same trace ID, the producer’s span becomes this hop’s parent, and a fresh span is minted for the consumer side — so async hops chain in the trace UI instead of starting orphan roots.

pub fn new_root() -> TraceContext

A brand-new root trace (for messages with no carried context).