Struct Span

pub struct Span {

    pub timestamp: Annotated<Timestamp>,
    pub start_timestamp: Annotated<Timestamp>,
    pub exclusive_time: Annotated<f64>,
    pub op: Annotated<OperationType>,
    pub span_id: Annotated<SpanId>,
    pub parent_span_id: Annotated<SpanId>,
    pub trace_id: Annotated<TraceId>,
    pub segment_id: Annotated<SpanId>,
    pub is_segment: Annotated<bool>,
    pub is_remote: Annotated<bool>,
    pub status: Annotated<SpanStatus>,
    pub description: Annotated<String>,
    pub tags: Annotated<Object<JsonLenientString>>,
    pub origin: Annotated<OriginType>,
    pub profile_id: Annotated<EventId>,
    pub data: Annotated<SpanData>,
    pub links: Annotated<Array<SpanLink>>,
    pub sentry_tags: Annotated<SentryTags>,
    pub received: Annotated<Timestamp>,
    pub measurements: Annotated<Measurements>,
    pub platform: Annotated<String>,
    pub was_transaction: Annotated<bool>,
    pub kind: Annotated<SpanKind>,
    pub _performance_issues_spans: Annotated<bool>,
    pub other: Object<Value>,
}

Fields

timestamp: Annotated<Timestamp>

Timestamp when the span was ended.

start_timestamp: Annotated<Timestamp>

Timestamp when the span started.

exclusive_time: Annotated<f64>

The amount of time in milliseconds spent in this span, excluding its immediate child spans.

op: Annotated<OperationType>

Span type (see OperationType docs).

span_id: Annotated<SpanId>

The Span id.

parent_span_id: Annotated<SpanId>

The ID of the span enclosing this span.

trace_id: Annotated<TraceId>

The ID of the trace the span belongs to.

segment_id: Annotated<SpanId>

A unique identifier for a segment within a trace (8 byte hexadecimal string).

For spans embedded in transactions, the segment_id is the span_id of the containing transaction.

is_segment: Annotated<bool>

Whether or not the current span is the root of the segment.

is_remote: Annotated<bool>

Indicates whether a span’s parent is remote.

For OpenTelemetry spans, this is derived from span flags bits 8 and 9. See SPAN_FLAGS_CONTEXT_HAS_IS_REMOTE_MASK and SPAN_FLAGS_CONTEXT_IS_REMOTE_MASK.

The states are:

• empty: unknown
• false: is not remote
• true: is remote

status: Annotated<SpanStatus>

The status of a span.

description: Annotated<String>

Human readable description of a span (e.g. method URL).

tags: Annotated<Object<JsonLenientString>>

Arbitrary tags on a span, like on the top-level event.

origin: Annotated<OriginType>

The origin of the span indicates what created the span (see OriginType docs).

profile_id: Annotated<EventId>

ID of a profile that can be associated with the span.

data: Annotated<SpanData>

Arbitrary additional data on a span.

Besides arbitrary user data, this object also contains SDK-provided fields used by the product (see https://develop.sentry.dev/sdk/performance/span-data-conventions/).

links: Annotated<Array<SpanLink>>

Links from this span to other spans

sentry_tags: Annotated<SentryTags>

Tags generated by Relay. These tags are a superset of the tags set on span metrics.

received: Annotated<Timestamp>

Timestamp when the span has been received by Sentry.

measurements: Annotated<Measurements>

Measurements which holds observed values such as web vitals.

platform: Annotated<String>

Platform identifier.

See Event::platform.

was_transaction: Annotated<bool>

Whether the span is a segment span that was converted from a transaction.

kind: Annotated<SpanKind>

_performance_issues_spans: Annotated<bool>

Temporary flag that controls where performance issues are detected.

When the flag is set to true, performance issues will be detected on this span provided it is a root (segment) instead of the transaction event.

Only set on root spans extracted from transactions.

other: Object<Value>

Additional arbitrary fields for forwards compatibility.

Trait Implementations

impl Clone for Span

fn clone(&self) -> Span

Returns a copy 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 Empty for Span

fn is_empty(&self) -> bool

Returns whether this value is empty.

fn is_deep_empty(&self) -> bool

Returns whether this value is empty or all of its descendants are empty.

impl From<&Event> for Span

fn from(event: &Event) -> Self

Converts to this type from the input type.

impl FromObjectRef for Span

fn from_object_ref(__obj: &mut Object<Value>) -> Self

Creates a meta structure from key value pairs.

impl FromValue for Span

fn from_value(__value: Annotated<Value>) -> Annotated<Self>

Creates a meta structure from an annotated boxed value.

impl Getter for Span

fn get_value(&self, path: &str) -> Option<Val<'_>>

Returns the serialized value of a field pointed to by a path.

fn get_iter(&self, _path: &str) -> Option<GetterIter<'_>>

Returns an iterator over the array pointed to by a path.

impl IntoObjectRef for Span

fn into_object_ref(self, __map: &mut Object<Value>)

Boxes the meta structure back into an object of values.

impl IntoValue for Span

fn into_value(self) -> Value

Boxes the meta structure back into a value.

fn serialize_payload<S>( &self, __serializer: S, __behavior: SkipSerialization, ) -> Result<S::Ok, S::Error>

where Self: Sized, S: Serializer,

Efficiently serializes the payload directly.

fn extract_child_meta(&self) -> MetaMap

where Self: Sized,

Extracts children meta map out of a value.

fn extract_meta_tree(value: &Annotated<Self>) -> MetaTree

where Self: Sized,

Extracts the meta tree out of annotated value.

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 ProcessValue for Span

fn value_type(&self) -> EnumSet<ValueType>

Returns the type of the value.

fn process_value<P>( &mut self, __meta: &mut Meta, __processor: &mut P, __state: &ProcessingState<'_>, ) -> ProcessingResult

where P: Processor,

Executes a processor on this value.

fn process_child_values<P>( &mut self, __processor: &mut P, __state: &ProcessingState<'_>, ) -> ProcessingResult

where P: Processor,

Recurses into children of this value.

impl StructuralPartialEq for Span