Struct TraceContext 

pub struct TraceContext {
    pub run: RunScope,
    pub step: Option<StepScope>,
    pub tool_call: Option<ToolCallScope>,
    pub policy_decision: Option<PolicyDecisionScope>,
    pub budget: Option<BudgetScope>,
    pub seed: Option<i64>,
    pub baggage: Vec<(String, String)>,
    /* private fields */
}

Trace context tying together run, step, tool, and policy scopes.

Fields

run: RunScope

step: Option<StepScope>

tool_call: Option<ToolCallScope>

policy_decision: Option<PolicyDecisionScope>

budget: Option<BudgetScope>

seed: Option<i64>

baggage: Vec<(String, String)>

Implementations

impl TraceContext

pub fn new(run: RunScope) -> Self

Create a new root trace context for a run.

pub fn with_trace_id(self, trace_id: TraceId) -> Self

Override the generated trace identifier (used for deterministic trace IDs).

pub fn with_span_id(self, span_id: SpanId) -> Self

Override the generated span identifier.

pub fn with_parent_span_id( self, parent_span_id: impl Into<Option<SpanId>>, ) -> Self

Set an explicit parent span identifier.

pub fn from_parent( run: RunScope, trace_id: TraceId, parent_span_id: SpanId, ) -> Self

Create a trace context from an existing trace_id/span_id pair, typically when continuing a trace injected by an upstream caller.

pub fn with_seed(self, seed: impl Into<Option<i64>>) -> Self

Attach a deterministic seed to the trace.

pub fn with_trace_flags(self, flags: TraceFlags) -> Self

Override the trace flags (e.g., when sampling is disabled).

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

Set an explicit W3C tracestate header value.

pub fn from_w3c( run: RunScope, traceparent: &str, tracestate: Option<&str>, baggage: Option<&str>, ) -> Result<Self>

Construct a trace context from W3C headers captured on ingress.

pub fn with_baggage<I, K, V>(self, baggage: I) -> Self

where I: IntoIterator<Item = (K, V)>, K: Into<String>, V: Into<String>,

Replace baggage entries (for example to propagate budgets or experiment IDs).

pub fn with_budget(self, budget: BudgetScope) -> Self

Attach budget scope metadata.

pub fn child_step(&self, scope: StepScope) -> Self

Generate a child span context representing a step.

pub fn child_tool_call(&self, scope: ToolCallScope) -> Self

Generate a child span context representing a tool call.

pub fn child_policy_decision(&self, scope: PolicyDecisionScope) -> Self

Generate a child span context representing a policy decision.

pub fn trace_id(&self) -> TraceId

Trace identifier as a TraceId.

pub fn span_id(&self) -> SpanId

Current span identifier.

pub fn trace_flags(&self) -> TraceFlags

Trace flags used when constructing spans.

pub fn parent_span_id(&self) -> Option<SpanId>

Parent span identifier, if any.

pub fn traceparent(&self) -> String

Compute the W3C traceparent header value.

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

Return the stored W3C tracestate header value, if any.

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

Return the formatted W3C baggage header, if any entries are present.

pub fn w3c_headers(&self) -> Vec<(String, String)>

Produce the standard set of W3C headers (traceparent, tracestate, baggage).

pub fn as_parent_context(&self) -> OtelContext

Build an OpenTelemetry context representing this trace (as a remote parent).

pub fn from_span_context( run: RunScope, step: Option<StepScope>, tool_call: Option<ToolCallScope>, policy_decision: Option<PolicyDecisionScope>, budget: Option<BudgetScope>, parent_span_id: Option<SpanId>, span_context: SpanContext, seed: Option<i64>, baggage: Vec<(String, String)>, ) -> Self

Construct a trace context from a recorded span (e.g., after creating a tracing span).

pub fn attributes(&self) -> Vec<KeyValue>

Convert the trace context into OpenTelemetry attributes using the fleetforge.* namespace.

pub fn to_json(&self) -> Value

Serialises the trace context into a JSON object suitable for inclusion in event payloads.

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

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

Formats the value using the given formatter.