Span • Rust AI Agent SDK

Span: A span representing a unit of work.

Span

Defined in the trace module.

Rust AI Agent SDK

A span representing a unit of work.

Name	Type	Description
`id`	`String`	Span ID
`parent_id`	`Option<String>`	Parent span ID
`trace_id`	`String`	Trace ID
`name`	`String`	Span name
`kind`	`SpanKind`	Span kind
`status`	`SpanStatus`	Span status
`start_offset`	`Duration`	Start time (as duration since trace start)
`end_offset`	`Option<Duration>`	End time (as duration since trace start)
`duration`	`Option<Duration>`	Duration
`attributes`	`HashMap<String`	Attributes
`serde_json`	`:Value>`	Attributes
`events`	`Vec<SpanEvent>`	Events
`error_message`	`Option<String>`	Error message (if status is Error)

rust

fn new(
        trace_id: impl Into<String>,
        name: impl Into<String>,
        kind: SpanKind,
        start_offset: Duration,
    ) -> Self

Create a new span.

Parameters:

rust

fn with_parent(mut self, parent_id: impl Into<String>) -> Self

Set parent span.

Parameters:

Name	Type
`parent_id`	`impl Into<String>`

rust

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

Add an attribute.

Parameters:

Name	Type
`key`	`impl Into<String>`
`value`	`impl Serialize`

rust

fn add_event(&mut self, event: SpanEvent) -> ()

Add an event.

Parameters:

Name	Type
`event`	`SpanEvent`

rust

fn end(&mut self, end_offset: Duration) -> ()

End the span.

Parameters:

Name	Type
`end_offset`	`Duration`

rust

fn set_error(&mut self, message: impl Into<String>) -> ()

Mark as error.

Parameters:

Name	Type
`message`	`impl Into<String>`

rust

fn is_ended(&self) -> bool

Check if span is ended.

praisonai/src/trace/mod.rs at line 81