Struct SpanGuard 

pub struct SpanGuard { /* private fields */ }

Stopwatch for one observed span that records on explicit finish or Drop.

Implementations

impl SpanGuard

pub fn new( manager: Arc<ObservabilityManager>, context: SpanContext, event_type: EventType, ) -> SpanGuard

Creates a span guard with success status and an immediate start time.

pub fn set_tokens(&mut self, tokens: ObservationTokenUsage)

Attaches token usage collected from provider output or estimation.

pub fn set_status(&mut self, status: EventStatus)

Overrides the final status before recording.

pub fn set_error(&mut self, error: ObservationError)

Marks the span as failed and attaches error metadata.

pub fn set_payload(&mut self, payload: Value)

Attaches optional payload data that will be redacted by the manager.

pub fn add_tag(&mut self, key: impl Into<String>, value: impl Into<String>)

Adds a safe tag to the event before recording.

pub fn record_now(&mut self)

Records the span immediately and prevents duplicate Drop recording.

Trait Implementations

impl Drop for SpanGuard

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.