io.opentelemetry.sdk.trace

Class Samplers

java.lang.Object

io.opentelemetry.sdk.trace.Samplers

@Immutable
public final class Samplers
extends Object

Static class to access a set of pre-defined Samplers.

Since:

0.1.0

Method Summary

Modifier and Type	Method and Description
static Sampler	alwaysOff() Returns a Sampler that always makes a "no" Sampler.SamplingResult for Span sampling.
static Sampler	alwaysOn() Returns a Sampler that always makes a "yes" Sampler.SamplingResult for Span sampling.
static Sampler.SamplingResult	emptySamplingResult(Sampler.Decision decision) Returns a Sampler.SamplingResult with empty attributes and Sampler.SamplingResult.getDecision() returning decision.
static Sampler	parentOrElse(Sampler delegateSampler) Returns a Sampler that always makes the same decision as the parent Span to whether or not to sample.
static Sampler	probability(double probability) Returns a new Probability Sampler.
static Sampler.SamplingResult	samplingResult(Sampler.Decision decision, io.opentelemetry.common.Attributes attributes) Returns a Sampler.SamplingResult with the given attributes and Sampler.SamplingResult.getDecision() returning decision.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

samplingResult

public static Sampler.SamplingResult samplingResult(Sampler.Decision decision,
                                                    io.opentelemetry.common.Attributes attributes)

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

This is meant for use by custom Sampler implementations.

Using #emptySamplingResult(Decision) 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 Sampler.SamplingResult.getAttributes(). A different object instance with the same elements may be returned.

Returns:

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

emptySamplingResult

public static Sampler.SamplingResult emptySamplingResult(Sampler.Decision decision)

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

This is meant for use by custom Sampler implementations.

Use #samplingResult(Decision, Attributes) if you need attributes.

Parameters:

decision - The decision made on the span.

Returns:

A Sampler.SamplingResult with empty attributes and the provided decision.

alwaysOn

public static Sampler alwaysOn()

Returns a Sampler that always makes a "yes" Sampler.SamplingResult for Span sampling.

Returns:

a Sampler that always makes a "yes" Sampler.SamplingResult for Span sampling.

Since:

0.1.0

alwaysOff

public static Sampler alwaysOff()

Returns a Sampler that always makes a "no" Sampler.SamplingResult for Span sampling.

Returns:

a Sampler that always makes a "no" Sampler.SamplingResult for Span sampling.

Since:

0.1.0

parentOrElse

public static Sampler parentOrElse(Sampler delegateSampler)

Returns a Sampler that always makes the same decision as the parent Span to whether or not to sample. If there is no parent, the Sampler uses the provided Sampler delegate to determine the sampling decision.

Parameters:

delegateSampler - the Sampler which is used to make the sampling decisions if the parent does not exist.

Returns:

a Sampler that follows the parent's sampling decision if one exists, otherwise following the delegate sampler's decision.

Since:

0.7.0

probability

public static Sampler probability(double probability)

Returns a new Probability Sampler. The probability of sampling a trace is equal to that of the specified probability.

Parameters:

probability - The desired probability of sampling. Must be within [0.0, 1.0].

Returns:

a new Probability Sampler.

Throws:

IllegalArgumentException - if probability is out of range