Struct SpanCollector 

pub struct SpanCollector { /* private fields */ }

Thread-local span collector. Accumulates completed spans and tracks the active span stack for automatic parent assignment.

Implementations

impl SpanCollector

pub fn new() -> Self

pub fn start(&mut self, kind: SpanKind, name: String) -> u64

Start a new span. Returns the span ID.

pub fn start_with_links( &mut self, kind: SpanKind, name: String, links: Vec<SpanLink>, ) -> u64

Start a new span with non-parent causal links. Returns the span ID.

pub fn start_detached_with_links( &mut self, kind: SpanKind, name: String, links: Vec<SpanLink>, ) -> u64

Start a root span with non-parent causal links. Returns the span ID.

pub fn set_metadata(&mut self, span_id: u64, key: &str, value: Value)

Attach metadata to an open span.

pub fn attach_metadata_if_absent( &mut self, span_id: u64, key: &str, value: Value, )

Attach metadata to an open or completed span unless the key exists.

pub fn record_event( &mut self, span_id: u64, name: String, attributes: BTreeMap<String, Value>, ) -> bool

Append a sub-phase annotation to an open span. Returns true if the event was attached; false if span_id does not match any open span (already closed or never opened).

pub fn open_start_unix_ms(&self, span_id: u64) -> Option<u64>

Read the wall-clock start of an open span.

pub fn end(&mut self, span_id: u64) -> Option<Span>

End a span. Moves it from open to completed and returns the finalized span so callers (e.g. std/timing) can read its duration_ms directly without re-scanning take_spans().

pub fn current_span_id(&self) -> Option<u64>

Get the current active span ID (if any).

pub fn span_link(&self, span_id: u64) -> Option<SpanLink>

Build a serializable link for an open span.

pub fn current_span_link(&self) -> Option<SpanLink>

Build a serializable link for the current active span.

pub fn take_spans(&mut self) -> Vec<Span>

Take all completed spans (drains the collector).

pub fn spans(&self) -> &[Span]

Peek at all completed spans (non-destructive).

pub fn reset(&mut self)

Reset the collector.

Trait Implementations

impl Default for SpanCollector

fn default() -> Self

Returns the “default value” for a type.