Struct TraceContext 

pub struct TraceContext { /* private fields */ }

A W3C Trace Context attached to a job, used to link a producer’s trace to the worker that processes the job.

The traceparent is validated on construction. With the opentelemetry feature enabled, Worker and the client wire this up automatically — you only need this type to bridge to or from an external trace propagation system by hand.

Implementations

impl TraceContext

pub fn new(traceparent: impl Into<String>) -> Result<Self, TraceContextError>

Creates a trace context from a W3C traceparent, validating its format.

The expected shape is version-trace_id-span_id-flags, e.g. 00-<32 hex>-<16 hex>-<2 hex>.

pub fn with_tracestate(self, ts: impl Into<String>) -> Self

Attaches a W3C tracestate (vendor-specific trace data).

pub fn traceparent(&self) -> &str

Returns the W3C traceparent.

pub fn tracestate(&self) -> Option<&str>

Returns the W3C tracestate, if one was set.

impl TraceContext

pub fn from_current_otel() -> Option<Self>

Captures the current OpenTelemetry context as a TraceContext, or None if there is no valid active span.

Requires the opentelemetry feature.

pub fn attach_to_otel(&self) -> ContextGuard

Installs this trace context as the current OpenTelemetry context for as long as the returned guard is held.

Requires the opentelemetry feature.

pub fn otel_span_context(&self) -> Option<SpanContext>

Decodes this trace context into an OpenTelemetry SpanContext, or None if it does not represent a valid span. Used to add a span link from the worker’s process span back to the producer.

Requires the opentelemetry feature.

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

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TraceContext