com.newrelic.agent.tracing.samplers

Class AdaptiveSampler

java.lang.Object

com.newrelic.agent.tracing.samplers.AdaptiveSampler

All Implemented Interfaces:

Sampler

public class AdaptiveSampler
extends java.lang.Object
implements Sampler

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AdaptiveSampler(int target, int reportPeriodSeconds)

Method Summary

Modifier and Type	Method and Description
float	calculatePriority(Transaction tx) Calculate priority given the current state of the sampler.
protected boolean	computeSampled()
static AdaptiveSampler	getSharedInstance() Factory method for getting a shared instance of the adaptive sampler.
int	getTarget()
java.lang.String	getType() Get the description/name of this Sampler
static void	setSharedTarget(int newTarget) Updates the SHARED_SAMPLER_INSTANCE to use a new target.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.newrelic.agent.tracing.samplers.Sampler

isValidTraceRatio, traceIdFromTransaction

Constructor Detail

AdaptiveSampler

protected AdaptiveSampler(int target,
                          int reportPeriodSeconds)

Method Detail

getSharedInstance

public static AdaptiveSampler getSharedInstance()

Factory method for getting a shared instance of the adaptive sampler. This is the instance used when a top-level sampling target only is specified. Its state may be shared across multiple contexts using adaptive sampling, which is why it is a singleton. Lazy-instantiated. Currently managed via synchronized as it should only be accessed a few times, when DistributedTraceImpl class is initialized.

Returns:

The AdaptiveSampler instance.

setSharedTarget

public static void setSharedTarget(int newTarget)

Updates the SHARED_SAMPLER_INSTANCE to use a new target. If the SHARED_SAMPLER_INSTANCE isn't already running, this method is a no-op.

Parameters:

newTarget - the new target value the shared sampler instance should use

calculatePriority

public float calculatePriority(Transaction tx)

Calculate priority given the current state of the sampler.

Specified by:

calculatePriority in interface Sampler

Parameters:

tx - the transaction to calculate the priority for

Returns:

A float in [0.0f, 2.0f]

getType

public java.lang.String getType()

Description copied from interface: Sampler

Get the description/name of this Sampler

Specified by:

getType in interface Sampler

Returns:

the current Sampler's description

computeSampled

protected boolean computeSampled()

getTarget

public int getTarget()