de.is24.util.monitoring.statsd

Class StatsdPlugin

java.lang.Object

de.is24.util.monitoring.AbstractMonitorPlugin

de.is24.util.monitoring.statsd.StatsdPlugin

All Implemented Interfaces:

MonitorPlugin

public class StatsdPlugin
extends AbstractMonitorPlugin

InApplicationMonitor plugin. Forwards monitoring to a Statsd server. Enable via InApplicationMonitor.getInstance().registerPlugin(new StatsdPlugin("myStatsdHost", 1234));

Field Summary

Fields

Modifier and Type	Field and Description
private StatsdClient	delegate
private double	highVolumeSampleRate
private double	sampleRate
private String	uniqueName

Constructor Summary

Constructors

Constructor and Description
StatsdPlugin(StatsdClient client, String uniqeName)
StatsdPlugin(String host, int port, String appName) Create a Statsd plugin with a specified host and port.
StatsdPlugin(String host, int port, String appName, double sampleRate) Create a Statsd plugin with a specified host and port.

Method Summary

Methods

Modifier and Type	Method and Description
void	addHighRateTimerMeasurement(String key, long timing)
void	addSingleEventTimerMeasurement(String name, long timing)
void	addTimerMeasurement(String key, long timing)
void	afterRemovalNotification()
String	getUniqueName()
void	incrementCounter(String key, int increment)
void	incrementHighRateCounter(String key, int increment)
private void	initHighVolumeSampleRate()
void	initializeCounter(String name)
void	initializeTimerMeasurement(String name)
private String	sanitizeKey(String key)

Methods inherited from class de.is24.util.monitoring.AbstractMonitorPlugin

equals, hashCode, register

Methods inherited from class java.lang.Object

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

Field Detail

delegate

private final StatsdClient delegate

uniqueName

private final String uniqueName

sampleRate

private double sampleRate

highVolumeSampleRate

private double highVolumeSampleRate

Constructor Detail

StatsdPlugin

public StatsdPlugin(String host,
            int port,
            String appName)
             throws UnknownHostException,
                    SocketException

Create a Statsd plugin with a specified host and port. caller needs to call register on the plugin to register it into the InApplicationMonitor

Parameters:

host - the host of the Statsd server.

port - the port of the Statsd server.

appName - a short application identifier to fulfill IS24 / Graphite naming scheme requirements through statsd

Throws:

UnknownHostException - if there is no such host as specified.

SocketException - if the socket to the host could not be opened.

StatsdPlugin

public StatsdPlugin(String host,
            int port,
            String appName,
            double sampleRate)
             throws UnknownHostException,
                    SocketException

Create a Statsd plugin with a specified host and port. caller needs to call register on the plugin to register it into the InApplicationMonitor

Parameters:

host - statsd host name

port - udp port statsd is listening on

appName - a short application identifier to fulfill IS24 / Graphite naming scheme requirements through statsd

sampleRate - a default sample rate to use for all metrics handled

Throws:

UnknownHostException

SocketException

StatsdPlugin

StatsdPlugin(StatsdClient client,
            String uniqeName)

Method Detail

afterRemovalNotification

public void afterRemovalNotification()

initHighVolumeSampleRate

private void initHighVolumeSampleRate()

getUniqueName

public String getUniqueName()

sanitizeKey

private String sanitizeKey(String key)

incrementCounter

public void incrementCounter(String key,
                    int increment)

incrementHighRateCounter

public void incrementHighRateCounter(String key,
                            int increment)

initializeCounter

public void initializeCounter(String name)

addTimerMeasurement

public void addTimerMeasurement(String key,
                       long timing)

addSingleEventTimerMeasurement

public void addSingleEventTimerMeasurement(String name,
                                  long timing)

initializeTimerMeasurement

public void initializeTimerMeasurement(String name)

addHighRateTimerMeasurement

public void addHighRateTimerMeasurement(String key,
                               long timing)