Package io.opentelemetry.sdk.trace.samplers

Interface SamplingResult

@Immutable
public interface SamplingResult

Sampling result returned by Sampler.shouldSample(Context, String, String, SpanKind, Attributes, List).

Method Summary

Modifier and Type	Method	Description
static SamplingResult	create(SamplingDecision decision)	Returns a SamplingResult with no attributes and getDecision() returning decision.
static SamplingResult	create(SamplingDecision decision, io.opentelemetry.api.common.Attributes attributes)	Returns a SamplingResult with the given attributes and getDecision() returning decision.
io.opentelemetry.api.common.Attributes	getAttributes()	Return tags which will be attached to the span.
SamplingDecision	getDecision()	Return decision on whether a span should be recorded, recorded and sampled or not recorded.
default io.opentelemetry.api.trace.TraceState	getUpdatedTraceState(io.opentelemetry.api.trace.TraceState parentTraceState)	Return an optionally-updated TraceState, based on the parent TraceState.

Method Detail

create

static SamplingResult create(SamplingDecision decision)

Returns a SamplingResult with no attributes and getDecision() returning decision.

This is meant for use by custom Sampler implementations.

Use create(SamplingDecision, Attributes) if you need attributes.

Parameters:

decision - The decision made on the span.

Returns:

A SamplingResult with empty attributes and the provided decision.

create

static SamplingResult create(SamplingDecision decision,
                             io.opentelemetry.api.common.Attributes attributes)

Returns a SamplingResult with the given attributes and getDecision() returning decision.

This is meant for use by custom Sampler implementations.

Using create(SamplingDecision) instead of this method is slightly faster and shorter if you don't need attributes.

Parameters:

decision - The decision made on the span.

attributes - The attributes to return from getAttributes(). A different object instance with the same elements may be returned.

Returns:

A SamplingResult with the attributes equivalent to attributes and the provided decision.

getDecision

SamplingDecision getDecision()

Return decision on whether a span should be recorded, recorded and sampled or not recorded.

Returns:

sampling result.

getAttributes

io.opentelemetry.api.common.Attributes getAttributes()

Return tags which will be attached to the span.

Returns:

attributes added to span. These attributes should be added to the span only when the sampling decision is SamplingDecision.RECORD_ONLY or SamplingDecision.RECORD_AND_SAMPLE.

getUpdatedTraceState

default io.opentelemetry.api.trace.TraceState getUpdatedTraceState(io.opentelemetry.api.trace.TraceState parentTraceState)

Return an optionally-updated TraceState, based on the parent TraceState. This may return the same TraceState that was provided originally, or an updated one.

Parameters:

parentTraceState - The TraceState from the parent span. Might be an empty TraceState, if there is no parent. This will be the same TraceState that was passed in via the SpanContext parameter on the Sampler.shouldSample(Context, String, String, SpanKind, Attributes, List) call.