com.timgroup.statsd

Interface DirectStatsDClient

All Superinterfaces:

AutoCloseable, Closeable, StatsDClient

All Known Implementing Classes:

NoOpDirectStatsDClient

public interface DirectStatsDClient
extends StatsDClient

DirectStatsDClient is an experimental extension of StatsDClient that allows for direct access to some dogstatsd features.

It is not recommended to use this client in production. This client might allow you to take advantage of new features in the agent before they are released, but it might also break your application.

Method Summary

Modifier and Type	Method and Description
void	recordDistributionValues(String aspect, double[] values, double sampleRate, String... tags) Records values for the specified named distribution.
void	recordDistributionValues(String aspect, long[] values, double sampleRate, String... tags) Records values for the specified named distribution.

Methods inherited from interface com.timgroup.statsd.StatsDClient

close, count, count, count, count, count, count, countWithTimestamp, countWithTimestamp, countWithTimestamp, countWithTimestamp, decrement, decrement, decrementCounter, decrementCounter, distribution, distribution, distribution, distribution, distribution, distribution, gauge, gauge, gauge, gauge, gauge, gauge, gaugeWithTimestamp, gaugeWithTimestamp, gaugeWithTimestamp, gaugeWithTimestamp, histogram, histogram, histogram, histogram, histogram, histogram, increment, increment, incrementCounter, incrementCounter, recordDistributionValue, recordDistributionValue, recordDistributionValue, recordDistributionValue, recordDistributionValue, recordDistributionValue, recordEvent, recordExecutionTime, recordExecutionTime, recordExecutionTime, recordGaugeValue, recordGaugeValue, recordGaugeValue, recordGaugeValue, recordGaugeValue, recordGaugeValue, recordHistogramValue, recordHistogramValue, recordHistogramValue, recordHistogramValue, recordHistogramValue, recordHistogramValue, recordServiceCheckRun, recordSetValue, recordSetValue, serviceCheck, stop, time, time, time

Method Detail

recordDistributionValues

void recordDistributionValues(String aspect,
                              double[] values,
                              double sampleRate,
                              String... tags)

Records values for the specified named distribution.

The method doesn't take care of breaking down the values array if it is too large. It's up to the caller to make sure the size is kept reasonable.

This method is a DataDog extension, and may not work with other servers.

This method is non-blocking and is guaranteed not to throw an exception.

Parameters:

aspect - the name of the distribution

values - the values to be incorporated in the distribution

sampleRate - percentage of time metric to be sent

tags - array of tags to be added to the data

recordDistributionValues

void recordDistributionValues(String aspect,
                              long[] values,
                              double sampleRate,
                              String... tags)

Records values for the specified named distribution.

The method doesn't take care of breaking down the values array if it is too large. It's up to the caller to make sure the size is kept reasonable.

This method is a DataDog extension, and may not work with other servers.

This method is non-blocking and is guaranteed not to throw an exception.

Parameters:

aspect - the name of the distribution

values - the values to be incorporated in the distribution

sampleRate - percentage of time metric to be sent

tags - array of tags to be added to the data