Enum tracing_tunnel::TracingEvent

#[non_exhaustive]
pub enum TracingEvent {
    NewCallSite {
        id: MetadataId,
        data: CallSiteData,
    },
    NewSpan {
        id: RawSpanId,
        parent_id: Option<RawSpanId>,
        metadata_id: MetadataId,
        values: TracedValues<String>,
    },
    FollowsFrom {
        id: RawSpanId,
        follows_from: RawSpanId,
    },
    SpanEntered {
        id: RawSpanId,
    },
    SpanExited {
        id: RawSpanId,
    },
    SpanCloned {
        id: RawSpanId,
    },
    SpanDropped {
        id: RawSpanId,
    },
    ValuesRecorded {
        id: RawSpanId,
        values: TracedValues<String>,
    },
    NewEvent {
        metadata_id: MetadataId,
        parent: Option<RawSpanId>,
        values: TracedValues<String>,
    },
}

Event produced during tracing.

These events are emitted by a TracingEventSender and then consumed by a TracingEventReceiver to pass tracing info across an API boundary.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NewCallSite

Fields

id: MetadataId

Unique ID of the call site that will be used to refer to it in the following events.

data: CallSiteData

Information about the call site.

New call site.

NewSpan

Fields

id: RawSpanId

Unique ID of the span that will be used to refer to it in the following events.

parent_id: Option<RawSpanId>

Parent span ID. None means using the contextual parent (i.e., the current span).

metadata_id: MetadataId

ID of the span metadata.

values: TracedValues<String>

Values associated with the span.

New tracing span.

FollowsFrom

Fields

id: RawSpanId

ID of the follower span.

follows_from: RawSpanId

ID of the source span.

New “follows from” relation between spans.

SpanEntered

Fields

id: RawSpanId

ID of the span.

Span was entered.

SpanExited

Fields

id: RawSpanId

ID of the span.

Span was exited.

SpanCloned

Fields

id: RawSpanId

ID of the span.

Span was cloned.

SpanDropped

Fields

id: RawSpanId

ID of the span.

Span was dropped (aka closed).

ValuesRecorded

Fields

id: RawSpanId

ID of the span.

values: TracedValues<String>

Recorded values.

New values recorded for a span.

NewEvent

Fields

metadata_id: MetadataId

ID of the event metadata.

parent: Option<RawSpanId>

Parent span ID. None means using the contextual parent (i.e., the current span).

values: TracedValues<String>

Values associated with the event.

New event.

Implementations

impl TracingEvent

pub fn normalize(events: &mut [Self])

Normalizes a captured sequence of events so that it does not contain information that changes between program runs (e.g., metadata IDs) or due to minor refactoring (source code lines). Normalized events can be used for snapshot testing and other purposes when reproducibility is important.

Trait Implementations

impl Clone for TracingEvent

fn clone(&self) -> TracingEvent

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TracingEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TracingEvent

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TracingEvent

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.