Struct Span 

pub struct Span {
    pub env: MetaString,
    pub version: MetaString,
    pub component: MetaString,
    pub kind: u32,
    pub attributes: FastHashMap<MetaString, AttributeValue>,
    /* private fields */
}

A span event.

Fields

env: MetaString

Per-span environment override. Overrides Trace.payload.env when non-empty.

version: MetaString

Per-span application version.

component: MetaString

Instrumentation component name.

kind: u32

Span kind (OTel values): 0=unspecified, 1=internal, 2=server, 3=client, 4=producer, 5=consumer.

attributes: FastHashMap<MetaString, AttributeValue>

Typed span-level attributes.

Implementations

impl Span

pub fn new( service: impl Into<MetaString>, name: impl Into<MetaString>, resource: impl Into<MetaString>, span_type: impl Into<MetaString>, span_id: u64, parent_id: u64, start: u64, duration: u64, error: i32, ) -> Self

Creates a new Span with all required fields.

pub fn with_service(self, service: impl Into<MetaString>) -> Self

Sets the service name.

pub fn with_name(self, name: impl Into<MetaString>) -> Self

Sets the operation name.

pub fn with_resource(self, resource: impl Into<MetaString>) -> Self

Sets the resource name.

pub fn with_span_id(self, span_id: u64) -> Self

Sets the span identifier.

pub fn with_parent_id(self, parent_id: u64) -> Self

Sets the parent span identifier.

pub fn with_start(self, start: u64) -> Self

Sets the start timestamp.

pub fn with_duration(self, duration: u64) -> Self

Sets the span duration.

pub fn with_error(self, error: i32) -> Self

Sets the error flag.

pub fn with_span_type(self, span_type: impl Into<MetaString>) -> Self

Sets the span type (for example, web, db, lambda).

pub fn with_attributes( self, attributes: impl Into<Option<FastHashMap<MetaString, AttributeValue>>>, ) -> Self

Replaces the span attributes map.

pub fn with_span_links( self, span_links: impl Into<Option<Vec<SpanLink>>>, ) -> Self

Replaces the span links collection.

pub fn with_span_events( self, span_events: impl Into<Option<Vec<SpanEvent>>>, ) -> Self

Replaces the span events collection.

pub fn with_env(self, env: impl Into<MetaString>) -> Self

Sets the per-span environment override.

pub fn with_version(self, version: impl Into<MetaString>) -> Self

Sets the per-span application version.

pub fn with_component(self, component: impl Into<MetaString>) -> Self

Sets the instrumentation component.

pub fn with_kind(self, kind: u32) -> Self

Sets the span kind.

pub fn service(&self) -> &str

Returns the service name.

pub fn name(&self) -> &str

Returns the operation name.

pub fn resource(&self) -> &str

Returns the resource name.

pub fn set_resource(&mut self, resource: impl Into<MetaString>)

Sets the resource name.

pub fn span_id(&self) -> u64

Returns the span identifier.

pub fn parent_id(&self) -> u64

Returns the parent span identifier.

pub fn start(&self) -> u64

Returns the start timestamp.

pub fn duration(&self) -> u64

Returns the span duration.

pub fn error(&self) -> i32

Returns the error flag.

pub fn span_type(&self) -> &str

Returns the span type.

pub fn span_links(&self) -> &[SpanLink]

Returns the span links collection.

pub fn span_events(&self) -> &[SpanEvent]

Returns the span events collection.

Trait Implementations

impl Clone for Span

fn clone(&self) -> Span

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Span

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

Formats the value using the given formatter.

impl Default for Span

fn default() -> Span

Returns the “default value” for a type.

impl PartialEq for Span

fn eq(&self, other: &Span) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Span