OpenTelemetryTailSampler Class

public sealed class OpenTelemetryTailSampler : OpenTelemetrySampler

No documentation is available.

Inheritance
OpenTelemetrySampler OpenTelemetryTailSampler

Constructors

NameDescription
OpenTelemetryTailSampler()

OpenTelemetryTailSampler()

OpenTelemetryTailSampler.cs
public OpenTelemetryTailSampler()

No documentation is available.

Properties

NameDescription
MaxBufferedSpansGets or sets how many spans can be buffered across all traces.
MaxBufferedSpansPerTraceGets or sets how many spans a single trace can buffer before OpenTelemetryTailSampler.OverflowPolicy is applied to it.
MaxTraceDurationGets or sets how long a trace is buffered while waiting for its root span.
OverflowPolicyGets or sets what happens to a trace that exceeds OpenTelemetryTailSampler.MaxBufferedSpansPerTrace.
ShouldSample
SweepIntervalGets or sets how often buffered traces are checked for reaching OpenTelemetryTailSampler.MaxTraceDuration.

Gets or sets how many spans can be buffered across all traces.

public int MaxBufferedSpans { get; set; }

Property value

int

Exceptions

ArgumentOutOfRangeException
The value is negative or zero.

Remarks

Reaching this limit evicts whole buffered traces, largest first, so that new traces keep being accepted and a trace within OpenTelemetryTailSampler.MaxBufferedSpansPerTrace is never truncated because of unrelated traffic. Evicted traces are remembered for OpenTelemetryTailSampler.MaxTraceDuration, so their later spans are dropped instead of being emitted as a fragment of the original trace.

MaxBufferedSpansPerTrace

OpenTelemetryTailSampler.cs

Gets or sets how many spans a single trace can buffer before OpenTelemetryTailSampler.OverflowPolicy is applied to it.

public int MaxBufferedSpansPerTrace { get; set; }

Property value

int

Exceptions

ArgumentOutOfRangeException
The value is negative or zero.

Gets or sets how long a trace is buffered while waiting for its root span.

public TimeSpan MaxTraceDuration { get; set; }

Property value

TimeSpan

Exceptions

ArgumentOutOfRangeException
The value is negative or zero.

Gets or sets what happens to a trace that exceeds OpenTelemetryTailSampler.MaxBufferedSpansPerTrace.

public OpenTelemetryTailBufferOverflowPolicy OverflowPolicy { get; set; }
public OpenTelemetryTraceTailSampling? ShouldSample { get; set; }

No documentation is available.

Gets or sets how often buffered traces are checked for reaching OpenTelemetryTailSampler.MaxTraceDuration.

public TimeSpan? SweepInterval { get; set; }

Property value

TimeSpan?

Exceptions

ArgumentOutOfRangeException
The value is negative or zero.

Remarks

Traces that never receive their root span are evaluated by a background sweep, so they are released even when no other trace is received. When null, the interval is a quarter of OpenTelemetryTailSampler.MaxTraceDuration.