com.codahale.metrics.graphite

Class GraphiteReporter

java.lang.Object

com.codahale.metrics.ScheduledReporter

com.codahale.metrics.graphite.GraphiteReporter

All Implemented Interfaces:

com.codahale.metrics.Reporter, Closeable, AutoCloseable

public class GraphiteReporter
extends com.codahale.metrics.ScheduledReporter

A reporter which publishes metric values to a Graphite server.

See Also:

Graphite - Scalable Realtime Graphing

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GraphiteReporter.Builder A builder for GraphiteReporter instances.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	GraphiteReporter(com.codahale.metrics.MetricRegistry registry, GraphiteSender graphite, com.codahale.metrics.Clock clock, String prefix, TimeUnit rateUnit, TimeUnit durationUnit, com.codahale.metrics.MetricFilter filter, ScheduledExecutorService executor, boolean shutdownExecutorOnStop, Set<com.codahale.metrics.MetricAttribute> disabledMetricAttributes) Creates a new GraphiteReporter instance.

Method Summary

Modifier and Type	Method and Description
protected String	format(double v)
static GraphiteReporter.Builder	forRegistry(com.codahale.metrics.MetricRegistry registry) Returns a new GraphiteReporter.Builder for GraphiteReporter.
void	report(SortedMap<String,com.codahale.metrics.Gauge> gauges, SortedMap<String,com.codahale.metrics.Counter> counters, SortedMap<String,com.codahale.metrics.Histogram> histograms, SortedMap<String,com.codahale.metrics.Meter> meters, SortedMap<String,com.codahale.metrics.Timer> timers)
void	stop()

Methods inherited from class com.codahale.metrics.ScheduledReporter

close, convertDuration, convertRate, getDisabledMetricAttributes, getDurationUnit, getRateUnit, isShutdownExecutorOnStop, report, start, start

Methods inherited from class java.lang.Object

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

Constructor Detail

GraphiteReporter

protected GraphiteReporter(com.codahale.metrics.MetricRegistry registry,
                           GraphiteSender graphite,
                           com.codahale.metrics.Clock clock,
                           String prefix,
                           TimeUnit rateUnit,
                           TimeUnit durationUnit,
                           com.codahale.metrics.MetricFilter filter,
                           ScheduledExecutorService executor,
                           boolean shutdownExecutorOnStop,
                           Set<com.codahale.metrics.MetricAttribute> disabledMetricAttributes)

Creates a new GraphiteReporter instance.

Parameters:

registry - the MetricRegistry containing the metrics this reporter will report

graphite - the GraphiteSender which is responsible for sending metrics to a Carbon server via a transport protocol

clock - the instance of the time. Use Clock.defaultClock() for the default

prefix - the prefix of all metric names (may be null)

rateUnit - the time unit of in which rates will be converted

durationUnit - the time unit of in which durations will be converted

filter - the filter for which metrics to report

executor - the executor to use while scheduling reporting of metrics (may be null).

shutdownExecutorOnStop - if true, then executor will be stopped in same time with this reporter

Method Detail

forRegistry

public static GraphiteReporter.Builder forRegistry(com.codahale.metrics.MetricRegistry registry)

Returns a new GraphiteReporter.Builder for GraphiteReporter.

Parameters:

registry - the registry to report

Returns:

a GraphiteReporter.Builder instance for a GraphiteReporter

report

public void report(SortedMap<String,com.codahale.metrics.Gauge> gauges,
                   SortedMap<String,com.codahale.metrics.Counter> counters,
                   SortedMap<String,com.codahale.metrics.Histogram> histograms,
                   SortedMap<String,com.codahale.metrics.Meter> meters,
                   SortedMap<String,com.codahale.metrics.Timer> timers)

Specified by:

report in class com.codahale.metrics.ScheduledReporter

stop

public void stop()

Overrides:

stop in class com.codahale.metrics.ScheduledReporter

format

protected String format(double v)