io.jaegertracing.internal.samplers

Class GuaranteedThroughputSampler

java.lang.Object

io.jaegertracing.internal.samplers.GuaranteedThroughputSampler

All Implemented Interfaces:

Sampler

public final class GuaranteedThroughputSampler
extends java.lang.Object
implements Sampler

GuaranteedThroughputSampler is a Sampler that guarantees a throughput by using a ProbabilisticSampler and RateLimitingSampler in tandem. The RateLimitingSampler is used to establish a lowerBound so that every operation is sampled at least once in the time interval defined by the lowerBound.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	TYPE

Constructor Summary

Constructors

Constructor and Description
GuaranteedThroughputSampler(double samplingRate, double lowerBound)

Method Summary

Modifier and Type	Method and Description
void	close() Release any resources used by the sampler.
SamplingStatus	sample(java.lang.String operation, long id) Calls Sampler.sample(String, long) (String, long)} on both samplers, returning true for SamplingStatus.isSampled if either samplers set #isSampled to true.
boolean	update(double samplingRate, double lowerBound) Updates the probabilistic and lowerBound samplers

Methods inherited from class java.lang.Object

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

Field Detail

TYPE

public static final java.lang.String TYPE

See Also:

Constant Field Values

Constructor Detail

GuaranteedThroughputSampler

public GuaranteedThroughputSampler(double samplingRate,
                                   double lowerBound)

Method Detail

update

public boolean update(double samplingRate,
                      double lowerBound)

Updates the probabilistic and lowerBound samplers

Parameters:

samplingRate - The sampling rate for probabilistic sampling

lowerBound - The lower bound limit for lower bound sampling

Returns:

true iff any samplers were updated

sample

public SamplingStatus sample(java.lang.String operation,
                             long id)

Calls Sampler.sample(String, long) (String, long)} on both samplers, returning true for SamplingStatus.isSampled if either samplers set #isSampled to true. The tags corresponding to the sampler that returned true are set on SamplingStatus.tags If both samplers return true, tags for ProbabilisticSampler is given priority.

Specified by:

sample in interface Sampler

Parameters:

operation - The operation name, which is ignored by this sampler

id - The traceId on the span

Returns:

whether or not the new trace should be sampled

close

public void close()

Description copied from interface: Sampler

Release any resources used by the sampler.

Specified by:

close in interface Sampler