Struct ExecutionTrace 

pub struct ExecutionTrace {
    pub trace_id: String,
    /* private fields */
}

An execution trace that collects spans for a single workflow run.

Fields

trace_id: String

Unique trace identifier (typically the workflow run ID).

Implementations

impl ExecutionTrace

pub fn new(trace_id: impl Into<String>) -> Self

Create a new execution trace.

pub fn start_span( &mut self, id: SpanId, name: impl Into<String>, ) -> &mut TraceSpan

Start a new root span.

Panics

This method will not panic; if the internal map entry is somehow missing after insertion the returned reference is obtained via Entry::or_insert_with, guaranteeing it exists.

pub fn start_child_span( &mut self, id: SpanId, parent: &SpanId, name: impl Into<String>, ) -> &mut TraceSpan

Start a child span under a parent.

Panics

Same guarantee as start_span.

pub fn finish_span(&mut self, id: &SpanId, status: SpanStatus)

Finish a span with the given status.

pub fn get_span(&self, id: &SpanId) -> Option<&TraceSpan>

Get a span by ID.

pub fn spans_ordered(&self) -> Vec<&TraceSpan>

Get all spans in creation order.

pub fn root_spans(&self) -> Vec<&TraceSpan>

Get only root spans (those without a parent).

pub fn children_of(&self, parent: &SpanId) -> Vec<&TraceSpan>

Get all children of a given span.

pub fn span_count(&self) -> usize

Return how many spans are in this trace.

pub fn running_count(&self) -> usize

Return how many spans are still running.

pub fn error_count(&self) -> usize

Return how many spans failed.

pub fn total_duration(&self) -> Option<Duration>

Compute total trace duration (from earliest start to latest end).

pub fn summary(&self) -> TraceSummary

Generate a simple summary of the trace.

Trait Implementations

impl Clone for ExecutionTrace

fn clone(&self) -> ExecutionTrace

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ExecutionTrace

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

Formats the value using the given formatter.