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(). Exclusion rules (excludes) take precedence, so if a name matches both excludes and includes, it is excluded.
useRegexFilters	false	Indicates whether the values of the 'includes' and 'excludes' fields should be treated as regular expressions or not.
frequency	none	The frequency to report metrics. Overrides the default.

Constructor Summary

Constructors

Constructor and Description
BaseReporterFactory()

Method Summary

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.
Optional<io.dropwizard.util.Duration>	getFrequency() Returns the frequency for reporting metrics.
com.google.common.collect.ImmutableSet<String>	getIncludes()
TimeUnit	getRateUnit()
boolean	getUseRegexFilters()
void	setDurationUnit(TimeUnit durationUnit)
void	setExcludes(com.google.common.collect.ImmutableSet<String> excludes)
void	setFrequency(Optional<io.dropwizard.util.Duration> frequency)
void	setIncludes(com.google.common.collect.ImmutableSet<String> includes)
void	setRateUnit(TimeUnit rateUnit)
void	setUseRegexFilters(boolean useRegexFilters)

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 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(Optional<io.dropwizard.util.Duration> frequency)

getUseRegexFilters

public boolean getUseRegexFilters()

setUseRegexFilters

public void setUseRegexFilters(boolean useRegexFilters)

getFilter

public com.codahale.metrics.MetricFilter getFilter()

Gets a MetricFilter that specifically includes and excludes configured metrics.

Filtering works in 4 ways:

unfiltered

All metrics are reported

excludes-only

All metrics are reported, except those whose name is listed in excludes.

includes-only

Only metrics whose name is listed in includes are reported.

mixed (both includes and excludes

Only metrics whose name is listed in includes and not listed in excludes are reported; excludes takes precedence over includes.

Returns:

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

See Also:

getIncludes(), getExcludes()