Struct Span 

pub struct Span { /* private fields */ }

A span event.

Implementations

impl Span

pub fn new( service: impl Into<MetaString>, name: impl Into<MetaString>, resource: impl Into<MetaString>, trace_id: u64, span_id: u64, ) -> Self

Creates a new Span with the required identifiers and names.

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_trace_id(self, trace_id: u64) -> Self

Sets the trace identifier.

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: i64) -> Self

Sets the start timestamp.

pub fn with_duration(self, duration: i64) -> 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 (e.g., web, db, lambda).

pub fn with_meta( self, meta: impl Into<Option<FastHashMap<MetaString, MetaString>>>, ) -> Self

Replaces the string-valued tag map.

pub fn with_metrics( self, metrics: impl Into<Option<FastHashMap<MetaString, f64>>>, ) -> Self

Replaces the numeric-valued tag map.

pub fn with_meta_struct( self, meta_struct: impl Into<Option<FastHashMap<MetaString, Vec<u8>>>>, ) -> Self

Replaces the structured metadata 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 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 trace_id(&self) -> u64

Returns the trace identifier.

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) -> i64

Returns the start timestamp.

pub fn duration(&self) -> i64

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 meta(&self) -> &FastHashMap<MetaString, MetaString>

Returns the string-valued tag map.

pub fn metrics(&self) -> &FastHashMap<MetaString, f64>

Returns the numeric-valued tag map.

pub fn meta_struct(&self) -> &FastHashMap<MetaString, Vec<u8>>

Returns the structured metadata map.

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