Struct Span 

pub struct Span<'a, P> { /* private fields */ }

A diagnostic event that represents a span in a distributed trace.

Spans are an extension of Events that explicitly take the well-known properties that signal an event as being a span. See the crate::span module for details.

A SpanEvent can be converted into an Event through its ToEvent implemenation, or passed directly to a crate::Emitter to emit it.

Implementations

impl<'a, P: Props> Span<'a, P>

pub fn new(mdl: impl Into<Path<'a>>, extent: impl ToExtent, props: P) -> Self

Create a new span event from its parts.

Each span consists of:

• mdl: The module that executed the operation the span is tracking.
• extent: The time the operation spent executing. The extent should be a span.
• props: Additional Props to associate with the span. These may include the SpanCtxt with the trace and span ids for the span, or they may be part of the ambient context.

pub fn mdl(&self) -> &Path<'a>

Get the module that executed the operation.

pub fn with_mdl(self, mdl: impl Into<Path<'a>>) -> Self

Set the module of the span.

pub fn name(&self) -> Option<Str<'_>>

Get the name of the executing operation.

pub fn with_name( self, name: impl Into<Str<'a>>, ) -> Span<'a, And<(&'static str, Str<'a>), P>>

Set the name of the executing operation.

pub fn kind(&self) -> Option<SpanKind>

Get the kind of the executing operation.

pub fn with_kind( self, kind: impl Into<SpanKind>, ) -> Span<'a, And<(&'static str, SpanKind), P>>

Set the kind of the executing operation.

pub fn ctxt(&self, ctxt: impl Ctxt) -> SpanCtxt

Get the ctxt of the executing operation.

This method accepts a Ctxt, which will be used to pull the SpanCtxt if this span doesn’t carry them in its own local props.

pub fn links(&self) -> Option<SpanLinkSet>

Get the set of spans linked to the executing operation.

pub fn with_links( self, links: impl Into<SpanLinkSet>, ) -> Span<'a, And<(&'static str, SpanLinkSet), P>>

Set the set of spans linked to the executing operation.

pub fn extent(&self) -> Option<&Extent>

Get the time the operation spent executing.

pub fn with_extent(self, extent: impl ToExtent) -> Self

Set the extent of the span.

pub fn ts(&self) -> Option<&Timestamp>

Get the extent of the metric as a point in time.

If the span has an extent then this method will return Some, with the result of Extent::as_point. If the span doesn’t have an extent then this method will return None.

pub fn ts_start(&self) -> Option<&Timestamp>

Get the start point of the extent of the span.

If the span has an extent, and that extent covers a timespan then this method will return Some. Otherwise this method will return None.

pub fn props(&self) -> &P

Get the additional properties associated with the span.

pub fn props_mut(&mut self) -> &mut P

Get exclusive access to the additional properties on the span.

pub fn with_props<U>(self, props: U) -> Span<'a, U>

Set the properties of the span.

pub fn map_props<U>(self, map: impl FnOnce(P) -> U) -> Span<'a, U>

Map the properties of the span.

pub fn tpl(&self) -> &Template<'a>

Get the template that will be used to render the span.

pub fn with_tpl(self, tpl: impl Into<Template<'a>>) -> Self

Set the template of the span.

pub fn erase<'b>(&'b self) -> Span<'b, &'b dyn ErasedProps>

Get a type-erased span, borrowing data from this one.

Trait Implementations

impl<'a, P: Props> Debug for Span<'a, P>

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

Formats the value using the given formatter.

impl<'a, P: Props> Props for Span<'a, P>

fn for_each<'kv, F: FnMut(Str<'kv>, Value<'kv>) -> ControlFlow<()>>( &'kv self, for_each: F, ) -> ControlFlow<()>

Enumerate the Str and Value pairs.

fn get<'v, K>(&'v self, key: K) -> Option<Value<'v>>

where K: ToStr,

Get the value for a given key, if it’s present.

fn pull<'kv, V, K>(&'kv self, key: K) -> Option<V>

where V: FromValue<'kv>, K: ToStr,

Get the value for a given key, if it’s present as an instance of V.

fn and_props<U>(self, other: U) -> And<Self, U>

where U: Props, Self: Sized,

Concatenate other to the end of self.

fn filter<F>(self, filter: F) -> Filter<Self, F>

where F: Fn(Str<'_>, Value<'_>) -> bool, Self: Sized,

Filter the set of properties.

fn collect<'kv, C>(&'kv self) -> C

where C: FromProps<'kv>,

Collect these properties into another collection type.

fn as_map(&self) -> &AsMap<Self>

where Self: Sized,

Get an adapter that will serialize properties as a map.

fn dedup(&self) -> &Dedup<Self>

where Self: Sized,

Lazily de-duplicate properties in the collection.

fn is_unique(&self) -> bool

Whether the collection is known not to contain any duplicate keys.

fn size(&self) -> Option<usize>

A hint on the number of properties in the collection.

impl<'a, P: Props> ToEvent for Span<'a, P>

type Props<'b> = &'b Span<'a, P> where Self: 'b

The kind of Props on the resulting value.

fn to_event<'b>(&'b self) -> Event<'b, Self::Props<'b>>

Perform the conversion.

impl<'a, P: Props> ToExtent for Span<'a, P>

fn to_extent(&self) -> Option<Extent>

Perform the conversion.