Struct TraceContext 

#[non_exhaustive]
pub struct TraceContext {
    pub trace_id: Vec<u8>,
    pub span_id: Vec<u8>,
    pub trace_flags: u8,
}

OTel-style trace context extracted from the current span.

Returned by current_trace_context for propagation into outbound HTTP calls (W3C traceparent header). The IDs are kept as opaque bytes so this type does not leak a specific OTel SDK version into the ABI crate; use TraceContext::to_traceparent to render the wire form.

#[non_exhaustive] so future fields (e.g. tracestate) can be added without breaking downstream struct-literal construction.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

trace_id: Vec<u8>

Trace identifier (16 bytes when populated, empty otherwise).

span_id: Vec<u8>

Span identifier (8 bytes when populated, empty otherwise).

trace_flags: u8

W3C trace flags (bit 0 = sampled). Zero when no context is present.

Implementations

impl TraceContext

pub fn to_traceparent(&self) -> Option<String>

Render the context as a W3C traceparent header value.

Returns None unless both IDs are present and correctly sized — i.e. there is a real context to propagate. The format is 00-<32 hex trace-id>-<16 hex span-id>-<2 hex flags>.

Trait Implementations

impl Clone for TraceContext

fn clone(&self) -> TraceContext

Returns a duplicate 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 Default for TraceContext

fn default() -> TraceContext

Returns the “default value” for a type.