com.yammer.metrics.reporting

Class GangliaReporter

java.lang.Object

com.yammer.metrics.reporting.AbstractReporter

com.yammer.metrics.reporting.AbstractPollingReporter

com.yammer.metrics.reporting.GangliaReporter

All Implemented Interfaces:

MetricProcessor<String>, Runnable

public class GangliaReporter
extends AbstractPollingReporter
implements MetricProcessor<String>

A simple reporter which sends out application metrics to a Ganglia server periodically.

NOTE: this reporter only works with Ganglia 3.1 and greater. The message protocol for earlier versions of Ganglia is different.

This code heavily borrows from GangliaWriter in JMXTrans which is based on GangliaContext31 from Hadoop.

Field Summary

Fields

Modifier and Type	Field and Description
boolean	printVMMetrics

Constructor Summary

Constructors

Constructor and Description
GangliaReporter(MetricsRegistry metricsRegistry, String gangliaHost, int port, String groupPrefix) Creates a new GangliaReporter.
GangliaReporter(MetricsRegistry metricsRegistry, String gangliaHost, int port, String groupPrefix, MetricPredicate predicate) Creates a new GangliaReporter.
GangliaReporter(MetricsRegistry metricsRegistry, String gangliaHost, int port, String groupPrefix, MetricPredicate predicate, boolean compressPackageNames) Creates a new GangliaReporter.
GangliaReporter(MetricsRegistry metricsRegistry, String groupPrefix, MetricPredicate predicate, boolean compressPackageNames, com.yammer.metrics.reporting.GangliaMessageBuilder gangliaMessageBuilder, VirtualMachineMetrics vm) Creates a new GangliaReporter.
GangliaReporter(String gangliaHost, int port) Creates a new GangliaReporter.
GangliaReporter(String gangliaHost, int port, boolean compressPackageNames) Creates a new GangliaReporter.

Method Summary

Methods

Modifier and Type	Method and Description
static void	enable(long period, TimeUnit unit, String gangliaHost, int port) Enables the ganglia reporter to send data for the default metrics registry to ganglia server with the specified period.
static void	enable(long period, TimeUnit unit, String gangliaHost, int port, boolean compressPackageNames) Enables the ganglia reporter to send data for the default metrics registry to ganglia server with the specified period.
static void	enable(long period, TimeUnit unit, String gangliaHost, int port, String groupPrefix) Enables the ganglia reporter to send data for the default metrics registry to ganglia server with the specified period.
static void	enable(MetricsRegistry metricsRegistry, long period, TimeUnit unit, String gangliaHost, int port, String groupPrefix) Enables the ganglia reporter to send data for the given metrics registry to ganglia server with the specified period.
static void	enable(MetricsRegistry metricsRegistry, long period, TimeUnit unit, String gangliaHost, int port, String groupPrefix, MetricPredicate predicate) Enables the ganglia reporter to send data to ganglia server with the specified period.
static void	enable(MetricsRegistry metricsRegistry, long period, TimeUnit unit, String gangliaHost, int port, String groupPrefix, MetricPredicate predicate, boolean compressPackageNames) Enables the ganglia reporter to send data to ganglia server with the specified period.
void	processCounter(MetricName name, Counter counter, String x)
void	processGauge(MetricName name, Gauge<?> gauge, String x)
void	processHistogram(MetricName name, Histogram histogram, String x)
void	processMeter(MetricName name, Metered meter, String x)
void	processTimer(MetricName name, Timer timer, String x)
void	run()
protected String	sanitizeName(MetricName name)

Methods inherited from class com.yammer.metrics.reporting.AbstractPollingReporter

shutdown, shutdown, start

Methods inherited from class com.yammer.metrics.reporting.AbstractReporter

getMetricsRegistry

Methods inherited from class java.lang.Object

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

Field Detail

printVMMetrics

public boolean printVMMetrics

Constructor Detail

GangliaReporter

public GangliaReporter(String gangliaHost,
               int port)
                throws IOException

Creates a new GangliaReporter.

Parameters:

gangliaHost - is ganglia server

port - is port on which ganglia server is running

Throws:

IOException - if there is an error connecting to the ganglia server

GangliaReporter

public GangliaReporter(String gangliaHost,
               int port,
               boolean compressPackageNames)
                throws IOException

Creates a new GangliaReporter.

Parameters:

gangliaHost - is ganglia server

port - is port on which ganglia server is running

compressPackageNames - whether or not Metrics' package names will be shortened

Throws:

IOException - if there is an error connecting to the ganglia server

GangliaReporter

public GangliaReporter(MetricsRegistry metricsRegistry,
               String gangliaHost,
               int port,
               String groupPrefix)
                throws IOException

Creates a new GangliaReporter.

Parameters:

metricsRegistry - the metrics registry

gangliaHost - is ganglia server

port - is port on which ganglia server is running

groupPrefix - prefix to the ganglia group name (such as myapp_counter)

Throws:

IOException - if there is an error connecting to the ganglia server

GangliaReporter

public GangliaReporter(MetricsRegistry metricsRegistry,
               String gangliaHost,
               int port,
               String groupPrefix,
               MetricPredicate predicate)
                throws IOException

Creates a new GangliaReporter.

Parameters:

metricsRegistry - the metrics registry

gangliaHost - is ganglia server

port - is port on which ganglia server is running

groupPrefix - prefix to the ganglia group name (such as myapp_counter)

predicate - filters metrics to be reported

Throws:

IOException - if there is an error connecting to the ganglia server

GangliaReporter

public GangliaReporter(MetricsRegistry metricsRegistry,
               String gangliaHost,
               int port,
               String groupPrefix,
               MetricPredicate predicate,
               boolean compressPackageNames)
                throws IOException

Creates a new GangliaReporter.

Parameters:

metricsRegistry - the metrics registry

gangliaHost - is ganglia server

port - is port on which ganglia server is running

groupPrefix - prefix to the ganglia group name (such as myapp_counter)

predicate - filters metrics to be reported

compressPackageNames - if true reporter will compress package names e.g. com.foo.MetricName becomes c.f.MetricName

Throws:

IOException - if there is an error connecting to the ganglia server

GangliaReporter

public GangliaReporter(MetricsRegistry metricsRegistry,
               String groupPrefix,
               MetricPredicate predicate,
               boolean compressPackageNames,
               com.yammer.metrics.reporting.GangliaMessageBuilder gangliaMessageBuilder,
               VirtualMachineMetrics vm)
                throws IOException

Creates a new GangliaReporter.

Parameters:

metricsRegistry - the metrics registry

groupPrefix - prefix to the ganglia group name (such as myapp_counter)

predicate - filters metrics to be reported

compressPackageNames - if true reporter will compress package names e.g. com.foo.MetricName becomes c.f.MetricName

gangliaMessageBuilder - a GangliaMessageBuilder instance

vm - a VirtualMachineMetrics isntance

Throws:

IOException - if there is an error connecting to the ganglia server

Method Detail

enable

public static void enable(long period,
          TimeUnit unit,
          String gangliaHost,
          int port)

Enables the ganglia reporter to send data for the default metrics registry to ganglia server with the specified period.

Parameters:

period - the period between successive outputs

unit - the time unit of period

gangliaHost - the gangliaHost name of ganglia server (carbon-cache agent)

port - the port number on which the ganglia server is listening

enable

public static void enable(long period,
          TimeUnit unit,
          String gangliaHost,
          int port,
          String groupPrefix)

Enables the ganglia reporter to send data for the default metrics registry to ganglia server with the specified period.

Parameters:

period - the period between successive outputs

unit - the time unit of period

gangliaHost - the gangliaHost name of ganglia server (carbon-cache agent)

port - the port number on which the ganglia server is listening

groupPrefix - prefix to the ganglia group name (such as myapp_counter)

enable

public static void enable(long period,
          TimeUnit unit,
          String gangliaHost,
          int port,
          boolean compressPackageNames)

Enables the ganglia reporter to send data for the default metrics registry to ganglia server with the specified period.

Parameters:

period - the period between successive outputs

unit - the time unit of period

gangliaHost - the gangliaHost name of ganglia server (carbon-cache agent)

port - the port number on which the ganglia server is listening

compressPackageNames - if true reporter will compress package names e.g. com.foo.MetricName becomes c.f.MetricName

enable

public static void enable(MetricsRegistry metricsRegistry,
          long period,
          TimeUnit unit,
          String gangliaHost,
          int port,
          String groupPrefix)

Enables the ganglia reporter to send data for the given metrics registry to ganglia server with the specified period.

Parameters:

metricsRegistry - the metrics registry

period - the period between successive outputs

unit - the time unit of period

gangliaHost - the gangliaHost name of ganglia server (carbon-cache agent)

port - the port number on which the ganglia server is listening

groupPrefix - prefix to the ganglia group name (such as myapp_counter)

enable

public static void enable(MetricsRegistry metricsRegistry,
          long period,
          TimeUnit unit,
          String gangliaHost,
          int port,
          String groupPrefix,
          MetricPredicate predicate)

Enables the ganglia reporter to send data to ganglia server with the specified period.

Parameters:

metricsRegistry - the metrics registry

period - the period between successive outputs

unit - the time unit of period

gangliaHost - the gangliaHost name of ganglia server (carbon-cache agent)

port - the port number on which the ganglia server is listening

groupPrefix - prefix to the ganglia group name (such as myapp_counter)

predicate - filters metrics to be reported

enable

public static void enable(MetricsRegistry metricsRegistry,
          long period,
          TimeUnit unit,
          String gangliaHost,
          int port,
          String groupPrefix,
          MetricPredicate predicate,
          boolean compressPackageNames)

Enables the ganglia reporter to send data to ganglia server with the specified period.

Parameters:

metricsRegistry - the metrics registry

period - the period between successive outputs

unit - the time unit of period

gangliaHost - the gangliaHost name of ganglia server (carbon-cache agent)

port - the port number on which the ganglia server is listening

groupPrefix - prefix to the ganglia group name (such as myapp_counter)

predicate - filters metrics to be reported

compressPackageNames - if true reporter will compress package names e.g. com.foo.MetricName becomes c.f.MetricName

run

public void run()

Specified by:

run in interface Runnable

Specified by:

run in class AbstractPollingReporter

processGauge

public void processGauge(MetricName name,
                Gauge<?> gauge,
                String x)
                  throws IOException

Specified by:

processGauge in interface MetricProcessor<String>

Throws:

IOException

processCounter

public void processCounter(MetricName name,
                  Counter counter,
                  String x)
                    throws IOException

Specified by:

processCounter in interface MetricProcessor<String>

Throws:

IOException

processMeter

public void processMeter(MetricName name,
                Metered meter,
                String x)
                  throws IOException

Specified by:

processMeter in interface MetricProcessor<String>

Throws:

IOException

processHistogram

public void processHistogram(MetricName name,
                    Histogram histogram,
                    String x)
                      throws IOException

Specified by:

processHistogram in interface MetricProcessor<String>

Throws:

IOException

processTimer

public void processTimer(MetricName name,
                Timer timer,
                String x)
                  throws IOException

Specified by:

processTimer in interface MetricProcessor<String>

Throws:

IOException

sanitizeName

protected String sanitizeName(MetricName name)