RecordingSentrySpanV2 class base

A span that records timing and attribute data for performance monitoring.

This span captures start/end timestamps, attributes, and status. When end is called, the span is passed to OnSpanEndCallback for processing.

Use RecordingSentrySpanV2.root to create a root span with a sampling decision, or RecordingSentrySpanV2.child to create a child span that inherits sampling from its parent.

Implemented types

• SentrySpanV2

Implementers

• IdleRecordingSentrySpanV2

Constructors

RecordingSentrySpanV2.child({required RecordingSentrySpanV2 parent, required String name, required OnSpanEndCallback onSpanEnd, required ClockProvider clock, required DscCreatorCallback dscCreator, DateTime? startTimestamp})

Creates a child span that inherits sampling from its parent.

factory

RecordingSentrySpanV2.root({required SentryId traceId, required String name, required OnSpanEndCallback onSpanEnd, required ClockProvider clock, required DscCreatorCallback dscCreator, required SentryTracesSamplingDecision samplingDecision, DateTime? startTimestamp})

Creates a root span with an explicit sampling decision.

factory

Properties

attributes → Map<String, SentryAttribute>

The read-only view of the attributes of this span using Map.unmodifiable.

no setter, override

endTimestamp → DateTime?

The end timestamp of this span.

no setter, override

hashCode → int

The hash code for this object.

no setter, inherited

isEnded → bool

Whether this span has ended.

no setter, override

name ↔ String

The name of this span.

getter/setter pair, override

parentSpan → RecordingSentrySpanV2?

The parent span of this span.

no setter, override

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

samplingDecision → SentryTracesSamplingDecision

The sampling decision for this span's trace.

no setter

segmentSpan → RecordingSentrySpanV2

The local root span of this trace segment.

no setter

spanId → SpanId

The id of this span.

no setter, override

startTimestamp → DateTime

The start timestamp of this span.

no setter, override

status ↔ SentrySpanStatusV2

The status of this span.

getter/setter pair, override

traceId → SentryId

The id of the trace this span belongs to.

no setter, override

Methods

end({DateTime? endTimestamp}) → void

Ends this span.

override

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

removeAttribute(String key) → void

Removes an attribute on this span with a matching key.

override

resolveDsc() → SentryTraceContextHeader

The segment's Dynamic Sampling Context (DSC) header.

setAttribute(String key, SentryAttribute value) → void

Sets an attribute on this span, replacing any existing attribute with the same key.

override

setAttributes(Map<String, SentryAttribute> attributes) → void

Sets attributes on this span, replacing existing attributes with the same keys.

override

setAttributesIfAbsent(Map<String, SentryAttribute> attributes) → void

toJson() → Map<String, dynamic>

toString() → String

A string representation of this object.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited