Package com.github.kristofa.brave

Class Sampler

java.lang.Object

com.github.kristofa.brave.Sampler

Direct Known Subclasses:

BoundarySampler, CountingSampler

Deprecated.

Replaced by brave.sampler.Sampler

@Deprecated
public abstract class Sampler
extends java.lang.Object

Sampler is responsible for deciding if a particular trace should be "sampled", i.e. whether the overhead of tracing will occur and/or if a trace will be reported to the collection tier.

Zipkin v1 uses before-the-fact sampling. This means that the decision to keep or drop the trace is made before any work is measured, or annotations are added. As such, the input parameter to zipkin v1 samplers is the trace ID (64-bit random number).

The instrumentation sampling decision happens once, at the root of the trace, and is propagated downstream. For this reason, the decision needn't be consistent based on trace ID.

Field Summary

Fields

Modifier and Type	Field	Description
static Sampler	ALWAYS_SAMPLE	Deprecated.
static Sampler	NEVER_SAMPLE	Deprecated.

Constructor Summary

Constructors

Constructor	Description
Sampler()	Deprecated.

Method Summary

Modifier and Type	Method	Description
static Sampler	create(float rate)	Deprecated. Returns a sampler, given a rate expressed as a percentage.
abstract boolean	isSampled(long traceId)	Deprecated. Returns true if the trace ID should be measured.

Methods inherited from class java.lang.Object

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

Field Detail

ALWAYS_SAMPLE

public static final Sampler ALWAYS_SAMPLE

Deprecated.

NEVER_SAMPLE

public static final Sampler NEVER_SAMPLE

Deprecated.

Constructor Detail

Sampler

public Sampler()

Deprecated.

Method Detail

isSampled

public abstract boolean isSampled(long traceId)

Deprecated.

Returns true if the trace ID should be measured.

create

public static Sampler create(float rate)

Deprecated.

Returns a sampler, given a rate expressed as a percentage.

The sampler returned is good for low volumes of traffic (<100K requests), as it is precise. If you have high volumes of traffic, consider BoundarySampler.

Parameters:

rate - minimum sample rate is 0.01, or 1% of traces