Struct TraceSpan 

pub struct TraceSpan {
    pub id: SpanId,
    pub parent: Option<SpanId>,
    pub name: String,
    pub start_time: SystemTime,
    pub end_time: Option<SystemTime>,
    pub duration: Option<Duration>,
    pub status: SpanStatus,
    pub attributes: Vec<SpanAttribute>,
}

A single span in an execution trace.

Fields

id: SpanId

Unique span identifier.

parent: Option<SpanId>

Optional parent span (for nesting).

name: String

Human-readable name of the operation.

start_time: SystemTime

When the span started.

end_time: Option<SystemTime>

When the span ended (if finished).

duration: Option<Duration>

Duration (calculated when ended).

status: SpanStatus

Current status of the span.

attributes: Vec<SpanAttribute>

Arbitrary key-value attributes.

Implementations

impl TraceSpan

pub fn start(id: SpanId, name: impl Into<String>) -> Self

Create a new span that starts now.

pub fn start_child(id: SpanId, parent: &SpanId, name: impl Into<String>) -> Self

Create a new child span.

pub fn finish(&mut self, status: SpanStatus)

End the span with the given status.

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

Add an attribute to the span.

pub fn is_running(&self) -> bool

Check if this span is still running.

pub fn is_root(&self) -> bool

Check if this span has a parent.

pub fn get_attribute(&self, key: &str) -> Option<&str>

Get the attribute value for a given key.

Trait Implementations

impl Clone for TraceSpan

fn clone(&self) -> TraceSpan

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TraceSpan

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

Formats the value using the given formatter.