Struct TraceContext 

pub struct TraceContext {
    pub request_id: String,
    pub trace_id: Option<String>,
    pub span_id: Option<String>,
    pub parent_span_id: Option<String>,
    pub device_id: Option<String>,
    pub protocol: Option<String>,
    pub operation: Option<String>,
    pub fields: HashMap<String, String>,
    pub created_at: u64,
}

Trace context for distributed tracing.

This struct carries context information that should be propagated across async boundaries and potentially across service boundaries.

Fields

request_id: String

Unique request/correlation ID.

trace_id: Option<String>

Trace ID (for distributed tracing systems).

span_id: Option<String>

Span ID (for distributed tracing systems).

parent_span_id: Option<String>

Parent span ID.

device_id: Option<String>

Device ID (if applicable).

protocol: Option<String>

Protocol name (if applicable).

operation: Option<String>

Operation name.

fields: HashMap<String, String>

Custom fields.

created_at: u64

Timestamp when context was created.

Implementations

impl TraceContext

pub fn new() -> Self

Create a new trace context with a generated request ID.

pub fn with_request_id(request_id: impl Into<String>) -> Self

Create a trace context with a specific request ID.

pub fn child(&self) -> Self

Create a child context (new span under same trace).

pub fn with_device_id(self, device_id: impl Into<String>) -> Self

Set the device ID.

pub fn with_protocol(self, protocol: impl Into<String>) -> Self

Set the protocol.

pub fn with_operation(self, operation: impl Into<String>) -> Self

Set the operation name.

pub fn with_trace_id(self, trace_id: impl Into<String>) -> Self

Set the trace ID (for integration with distributed tracing).

pub fn with_field( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

Add a custom field.

pub fn with_fields( self, fields: impl IntoIterator<Item = (String, String)>, ) -> Self

Add multiple custom fields.

pub fn create_span(&self, name: &'static str) -> Span

Create a tracing span with this context.

pub fn create_debug_span(&self, name: &'static str) -> Span

Create a debug-level span (for less critical operations).

pub fn age_ms(&self) -> u64

Get the age of this context in milliseconds.

pub fn is_older_than_ms(&self, ms: u64) -> bool

Check if this context is older than the given milliseconds.

pub fn to_map(&self) -> HashMap<String, String>

Convert to a map for logging or serialization.

pub fn from_headers(headers: &HashMap<String, String>) -> Self

Parse from HTTP headers (for distributed tracing).

pub fn to_headers(&self) -> HashMap<String, String>

Convert to HTTP headers (for distributed tracing).

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() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TraceContext

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TraceContext

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.