Struct opentelemetry::sdk::trace::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<(), Error>

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, Global>
)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, status: Status)

Sets the status of this Span.

If used, this will override the default span status, which is Status::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, Global>)where
    T: Into<Cow<'static, str>>,

Record an event in the context this span.

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

Record an error as an event for this span.

fn set_attributes(&mut self, attributes: impl IntoIterator<Item = KeyValue>)

Set multiple attributes of this span.

fn end(&mut self)

Signals that the operation described by this span has now ended.