tech.energyit.statsd

Class FastStatsDClient

java.lang.Object

tech.energyit.statsd.FastStatsDClient

All Implemented Interfaces:

StatsDClient

public final class FastStatsDClient
extends Object
implements StatsDClient

StatsDClient implementation uses thread-local ByteBuffer for efficient message format. For long values it has ZERO allocations. Important note : Maximal (total) message size can only be 1048576B,

Field Summary

Fields

Modifier and Type	Field and Description
static int	INITIAL_BUFFER_SIZE
static int	MAX_BUFFER_LENGTH
static Charset	MESSAGE_CHARSET

Constructor Summary

Constructors

Constructor and Description
FastStatsDClient(Sender sender)
FastStatsDClient(String prefix, Sender sender)
FastStatsDClient(String prefix, Sender sender, boolean exactDoubles)

Method Summary

Modifier and Type	Method and Description
void	clear()
void	count(byte[] aspect, double delta, double sampleRate, Tag... tags) Adjusts the specified counter by a given delta.
void	count(byte[] aspect, double delta, Tag... tags) Adjusts the specified counter by a given delta.
void	count(byte[] aspect, long delta, double sampleRate, Tag... tags) Adjusts the specified counter by a given delta.
void	count(byte[] aspect, long delta, Tag... tags) Adjusts the specified counter by a given delta.
void	gauge(byte[] aspect, char deltaSign, double value, Tag... tags) Records the delta value for the specified named gauge.
void	gauge(byte[] aspect, char deltaSign, long value, Tag... tags) Records the delta value for the specified named gauge.
void	gauge(byte[] aspect, double value, double sampleRate, Tag... tags) Records the latest fixed value for the specified named gauge.
void	gauge(byte[] aspect, double value, Tag... tags) Records the latest fixed value for the specified named gauge.
void	gauge(byte[] aspect, long value, double sampleRate, Tag... tags) Records the latest fixed value for the specified named gauge.
void	gauge(byte[] aspect, long value, Tag... tags) Records the latest fixed value for the specified named gauge.
void	histogram(byte[] aspect, double value, double sampleRate, Tag... tags) Records a value for the specified named histogram.
void	histogram(byte[] aspect, double value, Tag... tags) Records a value for the specified named histogram.
void	histogram(byte[] aspect, long value, double sampleRate, Tag... tags) Records a value for the specified named histogram.
void	histogram(byte[] aspect, long value, Tag... tags) Records a value for the specified named histogram.
void	meter(byte[] aspect, double value, Tag... tags) Records a value for the specified named meter.
void	meter(byte[] aspect, long value, Tag... tags) Records a value for the specified named meter.
void	set(byte[] aspect, double value, double sampleRate, Tag... tags) Records a value for the specified named set.
void	set(byte[] aspect, double value, Tag... tags) Records a value for the specified named set.
void	set(byte[] aspect, long value, double sampleRate, Tag... tags) Records a value for the specified named set.
void	set(byte[] aspect, long value, Tag... tags) Records a value for the specified named distribution.
void	time(byte[] aspect, long timeInMs, double sampleRate, Tag... tags) Records an execution time in milliseconds for the specified named operation.
void	time(byte[] aspect, long timeInMs, Tag... tags) Records an execution time in milliseconds for the specified named operation.

Methods inherited from class java.lang.Object

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

Field Detail

MESSAGE_CHARSET

public static final Charset MESSAGE_CHARSET

INITIAL_BUFFER_SIZE

public static final int INITIAL_BUFFER_SIZE

See Also:

Constant Field Values

MAX_BUFFER_LENGTH

public static final int MAX_BUFFER_LENGTH

See Also:

Constant Field Values

Constructor Detail

FastStatsDClient

public FastStatsDClient(Sender sender)

FastStatsDClient

public FastStatsDClient(String prefix,
                        Sender sender)

FastStatsDClient

public FastStatsDClient(String prefix,
                        Sender sender,
                        boolean exactDoubles)

Method Detail

count

public void count(byte[] aspect,
                  long delta,
                  Tag... tags)

Description copied from interface: StatsDClient

Adjusts the specified counter by a given delta.

Specified by:

count in interface StatsDClient

Parameters:

aspect - the name of the counter to adjust

delta - the amount to adjust the counter by

tags - array of tags to be added to the data

count

public void count(byte[] aspect,
                  long delta,
                  double sampleRate,
                  Tag... tags)

Description copied from interface: StatsDClient

Adjusts the specified counter by a given delta.

Specified by:

count in interface StatsDClient

Parameters:

aspect - the name of the counter to adjust

delta - the amount to adjust the counter by

sampleRate - percentage of time metric to be sent

tags - array of tags to be added to the data

count

public void count(byte[] aspect,
                  double delta,
                  Tag... tags)

Description copied from interface: StatsDClient

Adjusts the specified counter by a given delta.

Specified by:

count in interface StatsDClient

Parameters:

aspect - the name of the counter to adjust

delta - the amount to adjust the counter by

tags - array of tags to be added to the data

count

public void count(byte[] aspect,
                  double delta,
                  double sampleRate,
                  Tag... tags)

Description copied from interface: StatsDClient

Adjusts the specified counter by a given delta.

Specified by:

count in interface StatsDClient

Parameters:

aspect - the name of the counter to adjust

delta - the amount to adjust the counter by

sampleRate - percentage of time metric to be sent

tags - array of tags to be added to the data

gauge

public void gauge(byte[] aspect,
                  long value,
                  Tag... tags)

Description copied from interface: StatsDClient

Records the latest fixed value for the specified named gauge.

Specified by:

gauge in interface StatsDClient

Parameters:

aspect - the name of the gauge

value - the new reading of the gauge

gauge

public void gauge(byte[] aspect,
                  char deltaSign,
                  long value,
                  Tag... tags)

Description copied from interface: StatsDClient

Records the delta value for the specified named gauge.

Specified by:

gauge in interface StatsDClient

Parameters:

aspect - the name of the gauge

deltaSign - either '+' or '-' to indicate either increase or decrease gauge value

value - the (positive!) change of value

gauge

public void gauge(byte[] aspect,
                  long value,
                  double sampleRate,
                  Tag... tags)

Description copied from interface: StatsDClient

Records the latest fixed value for the specified named gauge.

Specified by:

gauge in interface StatsDClient

Parameters:

aspect - the name of the gauge

value - the new reading of the gauge

sampleRate - percentage of time metric to be sent

tags - array of tags to be added to the data

gauge

public void gauge(byte[] aspect,
                  double value,
                  Tag... tags)

Description copied from interface: StatsDClient

Records the latest fixed value for the specified named gauge.

Specified by:

gauge in interface StatsDClient

Parameters:

aspect - the name of the gauge

value - the new reading of the gauge

gauge

public void gauge(byte[] aspect,
                  char deltaSign,
                  double value,
                  Tag... tags)

Description copied from interface: StatsDClient

Records the delta value for the specified named gauge.

Specified by:

gauge in interface StatsDClient

Parameters:

aspect - the name of the gauge

deltaSign - either '+' or '-' to indicate either increase or decrease gauge value

value - the (positive!) change of value

gauge

public void gauge(byte[] aspect,
                  double value,
                  double sampleRate,
                  Tag... tags)

Description copied from interface: StatsDClient

Records the latest fixed value for the specified named gauge.

Specified by:

gauge in interface StatsDClient

Parameters:

aspect - the name of the gauge

value - the new reading of the gauge

sampleRate - percentage of time metric to be sent

tags - array of tags to be added to the data

time

public void time(byte[] aspect,
                 long timeInMs,
                 Tag... tags)

Description copied from interface: StatsDClient

Records an execution time in milliseconds for the specified named operation.

Specified by:

time in interface StatsDClient

Parameters:

aspect - the name of the timed operation

timeInMs - the time in milliseconds

tags - array of tags to be added to the data

time

public void time(byte[] aspect,
                 long timeInMs,
                 double sampleRate,
                 Tag... tags)

Description copied from interface: StatsDClient

Records an execution time in milliseconds for the specified named operation.

Specified by:

time in interface StatsDClient

Parameters:

aspect - the name of the timed operation

timeInMs - the time in milliseconds

sampleRate - percentage of time metric to be sent

tags - array of tags to be added to the data

histogram

public void histogram(byte[] aspect,
                      long value,
                      Tag... tags)

Description copied from interface: StatsDClient

Records a value for the specified named histogram.

Specified by:

histogram in interface StatsDClient

Parameters:

aspect - the name of the histogram

value - the value to be incorporated in the histogram

tags - array of tags to be added to the data

histogram

public void histogram(byte[] aspect,
                      long value,
                      double sampleRate,
                      Tag... tags)

Description copied from interface: StatsDClient

Records a value for the specified named histogram.

Specified by:

histogram in interface StatsDClient

Parameters:

aspect - the name of the histogram

value - the value to be incorporated in the histogram

sampleRate - percentage of time metric to be sent

tags - array of tags to be added to the data

histogram

public void histogram(byte[] aspect,
                      double value,
                      Tag... tags)

Description copied from interface: StatsDClient

Records a value for the specified named histogram.

Specified by:

histogram in interface StatsDClient

Parameters:

aspect - the name of the histogram

value - the value to be incorporated in the histogram

tags - array of tags to be added to the data

histogram

public void histogram(byte[] aspect,
                      double value,
                      double sampleRate,
                      Tag... tags)

Description copied from interface: StatsDClient

Records a value for the specified named histogram.

Specified by:

histogram in interface StatsDClient

Parameters:

aspect - the name of the histogram

value - the value to be incorporated in the histogram

sampleRate - percentage of time metric to be sent

tags - array of tags to be added to the data

set

public void set(byte[] aspect,
                long value,
                Tag... tags)

Description copied from interface: StatsDClient

Records a value for the specified named distribution.

Specified by:

set in interface StatsDClient

Parameters:

aspect - the name of the distribution

value - the value to be incorporated in the distribution

tags - array of tags to be added to the data

set

public void set(byte[] aspect,
                long value,
                double sampleRate,
                Tag... tags)

Description copied from interface: StatsDClient

Records a value for the specified named set.

Specified by:

set in interface StatsDClient

Parameters:

aspect - the name of the set

value - the value to be incorporated in the set

sampleRate - percentage of time metric to be sent

tags - array of tags to be added to the data

set

public void set(byte[] aspect,
                double value,
                Tag... tags)

Description copied from interface: StatsDClient

Records a value for the specified named set.

Specified by:

set in interface StatsDClient

Parameters:

aspect - the name of the set

value - the value to be incorporated in the set

tags - array of tags to be added to the data

set

public void set(byte[] aspect,
                double value,
                double sampleRate,
                Tag... tags)

Description copied from interface: StatsDClient

Records a value for the specified named set.

Specified by:

set in interface StatsDClient

Parameters:

aspect - the name of the set

value - the value to be incorporated in the set

sampleRate - percentage of time metric to be sent

tags - array of tags to be added to the data

meter

public void meter(byte[] aspect,
                  long value,
                  Tag... tags)

Description copied from interface: StatsDClient

Records a value for the specified named meter.

Specified by:

meter in interface StatsDClient

Parameters:

aspect - the name of the meter

value - the value to be incorporated in the meter

tags - array of tags to be added to the data

meter

public void meter(byte[] aspect,
                  double value,
                  Tag... tags)

Description copied from interface: StatsDClient

Records a value for the specified named meter.

Specified by:

meter in interface StatsDClient

Parameters:

aspect - the name of the meter

value - the value to be incorporated in the meter

tags - array of tags to be added to the data

clear

public void clear()