com.codahale.metrics

Class ScheduledReporter

java.lang.Object

com.codahale.metrics.ScheduledReporter

All Implemented Interfaces:

Reporter, java.io.Closeable, java.lang.AutoCloseable

Direct Known Subclasses:

ConsoleReporter, CsvReporter, Slf4jReporter

public abstract class ScheduledReporter
extends java.lang.Object
implements java.io.Closeable, Reporter

The abstract base class for all scheduled reporters (i.e., reporters which process a registry's metrics periodically).

See Also:

ConsoleReporter, CsvReporter, Slf4jReporter

Method Summary

Modifier and Type	Method and Description
void	close() Stops the reporter and shuts down its thread of execution.
void	report() Report the current values of all metrics in the registry.
abstract void	report(java.util.SortedMap<java.lang.String,Gauge> gauges, java.util.SortedMap<java.lang.String,Counter> counters, java.util.SortedMap<java.lang.String,Histogram> histograms, java.util.SortedMap<java.lang.String,Meter> meters, java.util.SortedMap<java.lang.String,Timer> timers) Called periodically by the polling thread.
void	start(long initialDelay, long period, java.util.concurrent.TimeUnit unit) Starts the reporter polling at the given period.
void	start(long period, java.util.concurrent.TimeUnit unit) Starts the reporter polling at the given period.
void	stop() Stops the reporter and if shutdownExecutorOnStop is true then shuts down its thread of execution.

Methods inherited from class java.lang.Object

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

Method Detail

start

public void start(long period,
                  java.util.concurrent.TimeUnit unit)

Starts the reporter polling at the given period.

Parameters:

period - the amount of time between polls

unit - the unit for period

start

public void start(long initialDelay,
                  long period,
                  java.util.concurrent.TimeUnit unit)

Starts the reporter polling at the given period.

Parameters:

initialDelay - the time to delay the first execution

period - the amount of time between polls

unit - the unit for period

stop

public void stop()

Stops the reporter and if shutdownExecutorOnStop is true then shuts down its thread of execution. Uses the shutdown pattern from http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/ExecutorService.html

close

public void close()

Stops the reporter and shuts down its thread of execution.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

report

public void report()

Report the current values of all metrics in the registry.

report

public abstract void report(java.util.SortedMap<java.lang.String,Gauge> gauges,
                            java.util.SortedMap<java.lang.String,Counter> counters,
                            java.util.SortedMap<java.lang.String,Histogram> histograms,
                            java.util.SortedMap<java.lang.String,Meter> meters,
                            java.util.SortedMap<java.lang.String,Timer> timers)

Called periodically by the polling thread. Subclasses should report all the given metrics.

Parameters:

gauges - all of the gauges in the registry

counters - all of the counters in the registry

histograms - all of the histograms in the registry

meters - all of the meters in the registry

timers - all of the timers in the registry