Struct Span

pub struct Span { /* private fields */ }

Available on crate feature trace only.

Single operation within a trace.

Implementations

impl Span

pub fn exported_data(&self) -> Option<SpanData>

Convert information in this span into exporter::trace::SpanData. This function copies all data from the current span, which will create a overhead.

Trait Implementations

impl Debug for Span

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

Formats the value using the given formatter.

impl Drop for Span

fn drop(&mut self)

Report span on inner drop

impl Span for Span

fn add_event_with_timestamp<T>( &mut self, name: T, timestamp: SystemTime, attributes: Vec<KeyValue>, )

where T: Into<Cow<'static, str>>,

Records events at a specific time in the context of a given Span.

Note that the OpenTelemetry project documents certain “standard event names and keys” which have prescribed semantic meanings.

fn span_context(&self) -> &SpanContext

Returns the SpanContext for the given Span.

fn is_recording(&self) -> bool

Returns true if this Span is recording information like events with the add_event operation, attributes using set_attributes, status with set_status, etc. Always returns false after span end.

fn set_attribute(&mut self, attribute: KeyValue)

Sets a single Attribute where the attribute properties are passed as arguments.

Note that the OpenTelemetry project documents certain “standard attributes” that have prescribed semantic meanings.

fn set_status(&mut self, code: StatusCode, message: String)

Sets the status of the Span. If used, this will override the default Span status, which is Unset. message MUST be ignored when the status is OK or Unset

fn update_name<T>(&mut self, new_name: T)

where T: Into<Cow<'static, str>>,

Updates the Span’s name.

fn end_with_timestamp(&mut self, timestamp: SystemTime)

Finishes the span with given timestamp.

fn add_event<T>(&mut self, name: T, attributes: Vec<KeyValue>)

where T: Into<Cow<'static, str>>,

An API to record events in the context of a given Span.

fn record_exception(&mut self, err: &dyn Error)

Convenience method to record an exception/error as an Event

fn record_exception_with_stacktrace<T>( &mut self, err: &dyn Error, stacktrace: T, )

where T: Into<Cow<'static, str>>,

Convenience method to record a exception/error as an Event with custom stacktrace

fn end(&mut self)

Finishes the Span.