Struct Span 

pub struct Span {
    pub context: SpanContext,
    pub name: String,
    pub start_ns: u64,
    pub end_ns: Option<u64>,
    pub attributes: HashMap<String, AttributeValue>,
    pub events: Vec<SpanEvent>,
    pub status: SpanStatus,
}

A single unit of work in a distributed trace.

Fields

context: SpanContext

Sampling and identity context.

name: String

Human-readable operation name.

start_ns: u64

Nanoseconds since UNIX epoch when the span started.

end_ns: Option<u64>

Nanoseconds since UNIX epoch when the span ended, or None if still in progress.

attributes: HashMap<String, AttributeValue>

Key-value attributes describing the operation.

events: Vec<SpanEvent>

Timestamped events that occurred during this span.

status: SpanStatus

Completion status of this span.

Implementations

impl Span

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

Sets a key-value attribute on this span.

pub fn add_event( &mut self, name: impl Into<String>, attributes: HashMap<String, AttributeValue>, )

Appends a named event with optional attributes to this span.

pub fn finish(&mut self)

Marks this span as finished by recording the current time as end_ns.

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

Returns the duration of this span in nanoseconds, or None if it has not yet finished.

Trait Implementations

impl Debug for Span

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

Formats the value using the given formatter.