io.dropwizard.metrics

Class BaseReporterFactory

java.lang.Object

io.dropwizard.metrics.BaseReporterFactory

All Implemented Interfaces:

Discoverable, ReporterFactory

Direct Known Subclasses:

BaseFormattedReporterFactory, Slf4jReporterFactory

public abstract class BaseReporterFactory
extends Object
implements ReporterFactory

A base ReporterFactory for configuring metric reporters.

Configures options common to all ScheduledReporters.

Configuration Parameters:

Name	Default	Description
durationUnit	milliseconds	The unit to report durations as. Overrides per-metric duration units.
rateUnit	seconds	The unit to report rates as. Overrides per-metric rate units.
excludes	No excluded metrics.	Metrics to exclude from reports, by name. When defined, matching metrics will not be reported. See getFilter().
includes	All metrics included.	Metrics to include in reports, by name. When defined, only these metrics will be reported. See getFilter().
frequency	1 second	The frequency to report metrics. Overrides the default.

Constructor Summary

Constructors

Constructor and Description
BaseReporterFactory()

Method Summary

Methods

Modifier and Type	Method and Description
TimeUnit	getDurationUnit()
com.google.common.collect.ImmutableSet<String>	getExcludes()
com.codahale.metrics.MetricFilter	getFilter() Gets a MetricFilter that specifically includes and excludes configured metrics.
com.google.common.base.Optional<io.dropwizard.util.Duration>	getFrequency() Returns the frequency for reporting metrics.
com.google.common.collect.ImmutableSet<String>	getIncludes()
TimeUnit	getRateUnit()
void	setDurationUnit(TimeUnit durationUnit)
void	setExcludes(com.google.common.collect.ImmutableSet<String> excludes)
void	setFrequency(com.google.common.base.Optional<io.dropwizard.util.Duration> frequency)
void	setIncludes(com.google.common.collect.ImmutableSet<String> includes)
void	setRateUnit(TimeUnit rateUnit)

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.dropwizard.metrics.ReporterFactory

build

Constructor Detail

BaseReporterFactory

public BaseReporterFactory()

Method Detail

getDurationUnit

public TimeUnit getDurationUnit()

setDurationUnit

public void setDurationUnit(TimeUnit durationUnit)

getRateUnit

public TimeUnit getRateUnit()

setRateUnit

public void setRateUnit(TimeUnit rateUnit)

getIncludes

public com.google.common.collect.ImmutableSet<String> getIncludes()

setIncludes

public void setIncludes(com.google.common.collect.ImmutableSet<String> includes)

getExcludes

public com.google.common.collect.ImmutableSet<String> getExcludes()

setExcludes

public void setExcludes(com.google.common.collect.ImmutableSet<String> excludes)

getFrequency

public com.google.common.base.Optional<io.dropwizard.util.Duration> getFrequency()

Description copied from interface: ReporterFactory

Returns the frequency for reporting metrics.

Specified by:

getFrequency in interface ReporterFactory

Returns:

the frequency for reporting metrics.

setFrequency

public void setFrequency(com.google.common.base.Optional<io.dropwizard.util.Duration> frequency)

getFilter

public com.codahale.metrics.MetricFilter getFilter()

Gets a MetricFilter that specifically includes and excludes configured metrics.

Filtering works in 3 ways:

excludes-only

All metrics are reported, except those with a name listed in excludes.

includes-only

No metrics are reported, except those with a name listed in includes.

mixed (both includes and excludes

All metrics are reported, except those with a name listed in excludes, unless they're also listed in includes (includes takes precedence).

Returns:

the filter for selecting metrics based on the configured excludes/includes.

See Also:

getIncludes(), getExcludes()