Package io.dropwizard.metrics5

Class NoopMetricRegistry

java.lang.Object

io.dropwizard.metrics5.MetricRegistry

io.dropwizard.metrics5.NoopMetricRegistry

All Implemented Interfaces:

Metric, MetricSet

public final class NoopMetricRegistry
extends MetricRegistry

A registry of metric instances which never creates or registers any metrics and returns no-op implementations of any metric type.

Since:

4.1.17

Nested Class Summary

Nested classes/interfaces inherited from class io.dropwizard.metrics5.MetricRegistry

MetricRegistry.MetricSupplier<T extends Metric>

Constructor Summary

Constructors

Constructor	Description
NoopMetricRegistry()

Method Summary

Modifier and Type	Method	Description
void	addListener(MetricRegistryListener listener)	Adds a MetricRegistryListener to a collection of listeners that will be notified on metric creation.
protected ConcurrentMap<MetricName,Metric>	buildMap()	Creates a new ConcurrentMap implementation for use inside the registry.
Counter	counter(MetricName name)	Return the Counter registered under this name; or create and register a new Counter if none is registered.
<T extends Counter> T	counter(MetricName name, MetricRegistry.MetricSupplier<T> supplier)	Return the Counter registered under this name; or create and register a new Counter using the provided MetricSupplier if none is registered.
Counter	counter(String name)	See MetricRegistry.counter(MetricName)
<T extends Gauge> T	gauge(MetricName name)	Return the Gauge registered under this name; or create and register a new SettableGauge if none is registered.
<T extends Gauge> T	gauge(MetricName name, MetricRegistry.MetricSupplier<T> supplier)	Return the Gauge registered under this name; or create and register a new Gauge using the provided MetricSupplier if none is registered.
SortedMap<MetricName,Counter>	getCounters()	Returns a map of all the counters in the registry and their names.
SortedMap<MetricName,Counter>	getCounters(MetricFilter filter)	Returns a map of all the counters in the registry and their names which match the given filter.
SortedMap<MetricName,Gauge<?>>	getGauges()	Returns a map of all the gauges in the registry and their names.
SortedMap<MetricName,Gauge<?>>	getGauges(MetricFilter filter)	Returns a map of all the gauges in the registry and their names which match the given filter.
SortedMap<MetricName,Histogram>	getHistograms()	Returns a map of all the histograms in the registry and their names.
SortedMap<MetricName,Histogram>	getHistograms(MetricFilter filter)	Returns a map of all the histograms in the registry and their names which match the given filter.
SortedMap<MetricName,Meter>	getMeters()	Returns a map of all the meters in the registry and their names.
SortedMap<MetricName,Meter>	getMeters(MetricFilter filter)	Returns a map of all the meters in the registry and their names which match the given filter.
Map<MetricName,Metric>	getMetrics()	A map of metric names to metrics.
SortedSet<MetricName>	getNames()	Returns a set of the names of all the metrics in the registry.
SortedMap<MetricName,Timer>	getTimers()	Returns a map of all the timers in the registry and their names.
SortedMap<MetricName,Timer>	getTimers(MetricFilter filter)	Returns a map of all the timers in the registry and their names which match the given filter.
Histogram	histogram(MetricName name)	Return the Histogram registered under this name; or create and register a new Histogram if none is registered.
Histogram	histogram(MetricName name, MetricRegistry.MetricSupplier<Histogram> supplier)	Return the Histogram registered under this name; or create and register a new Histogram using the provided MetricSupplier if none is registered.
Histogram	histogram(String name)	See MetricRegistry.histogram(MetricName)
Meter	meter(MetricName name)	Return the Meter registered under this name; or create and register a new Meter if none is registered.
Meter	meter(MetricName name, MetricRegistry.MetricSupplier<Meter> supplier)	Return the Meter registered under this name; or create and register a new Meter using the provided MetricSupplier if none is registered.
Meter	meter(String name)	See MetricRegistry.meter(MetricName)
<T extends Metric> T	register(MetricName name, T metric)	Given a Metric, registers it under the given name.
<T extends Metric> T	register(String name, T metric)	See MetricRegistry.register(MetricName, Metric)
void	registerAll(MetricName prefix, MetricSet metrics)
void	registerAll(MetricSet metrics)	Given a metric set, registers them.
boolean	remove(MetricName name)	Removes the metric with the given name.
void	removeListener(MetricRegistryListener listener)	Removes a MetricRegistryListener from this registry's collection of listeners.
void	removeMatching(MetricFilter filter)	Removes all metrics which match the given filter.
Timer	timer(MetricName name)	Return the Timer registered under this name; or create and register a new Timer if none is registered.
Timer	timer(MetricName name, MetricRegistry.MetricSupplier<Timer> supplier)	Return the Timer registered under this name; or create and register a new Timer using the provided MetricSupplier if none is registered.
Timer	timer(String name)	See MetricRegistry.timer(MetricName)

Methods inherited from class io.dropwizard.metrics5.MetricRegistry

name, name

Methods inherited from class java.lang.Object

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

Constructor Detail

NoopMetricRegistry

public NoopMetricRegistry()

Method Detail

buildMap

protected ConcurrentMap<MetricName,Metric> buildMap()

Creates a new ConcurrentMap implementation for use inside the registry. Override this to create a MetricRegistry with space- or time-bounded metric lifecycles, for example.

Overrides:

buildMap in class MetricRegistry

Returns:

register

public <T extends Metric> T register(String name,
                                     T metric)
                              throws IllegalArgumentException

See MetricRegistry.register(MetricName, Metric)

Overrides:

register in class MetricRegistry

Throws:

IllegalArgumentException

registerAll

public void registerAll(MetricSet metrics)
                 throws IllegalArgumentException

Given a metric set, registers them.

Overrides:

registerAll in class MetricRegistry

Parameters:

metrics - a set of metrics

Throws:

IllegalArgumentException - if any of the names are already registered

counter

public Counter counter(String name)

See MetricRegistry.counter(MetricName)

Overrides:

counter in class MetricRegistry

counter

public Counter counter(MetricName name)

Return the Counter registered under this name; or create and register a new Counter if none is registered.

Overrides:

counter in class MetricRegistry

Parameters:

name - the name of the metric

Returns:

a new or pre-existing Counter

counter

public <T extends Counter> T counter(MetricName name,
                                     MetricRegistry.MetricSupplier<T> supplier)

Return the Counter registered under this name; or create and register a new Counter using the provided MetricSupplier if none is registered.

Overrides:

counter in class MetricRegistry

Parameters:

name - the name of the metric

supplier - a MetricSupplier that can be used to manufacture a counter.

Returns:

a new or pre-existing Counter

histogram

public Histogram histogram(String name)

See MetricRegistry.histogram(MetricName)

Overrides:

histogram in class MetricRegistry

histogram

public Histogram histogram(MetricName name)

Return the Histogram registered under this name; or create and register a new Histogram if none is registered.

Overrides:

histogram in class MetricRegistry

Parameters:

name - the name of the metric

Returns:

a new or pre-existing Histogram

histogram

public Histogram histogram(MetricName name,
                           MetricRegistry.MetricSupplier<Histogram> supplier)

Return the Histogram registered under this name; or create and register a new Histogram using the provided MetricSupplier if none is registered.

Overrides:

histogram in class MetricRegistry

Parameters:

name - the name of the metric

supplier - a MetricSupplier that can be used to manufacture a histogram

Returns:

a new or pre-existing Histogram

meter

public Meter meter(String name)

See MetricRegistry.meter(MetricName)

Overrides:

meter in class MetricRegistry

meter

public Meter meter(MetricName name)

Return the Meter registered under this name; or create and register a new Meter if none is registered.

Overrides:

meter in class MetricRegistry

Parameters:

name - the name of the metric

Returns:

a new or pre-existing Meter

meter

public Meter meter(MetricName name,
                   MetricRegistry.MetricSupplier<Meter> supplier)

Return the Meter registered under this name; or create and register a new Meter using the provided MetricSupplier if none is registered.

Overrides:

meter in class MetricRegistry

Parameters:

name - the name of the metric

supplier - a MetricSupplier that can be used to manufacture a Meter

Returns:

a new or pre-existing Meter

timer

public Timer timer(String name)

See MetricRegistry.timer(MetricName)

Overrides:

timer in class MetricRegistry

timer

public Timer timer(MetricName name)

Return the Timer registered under this name; or create and register a new Timer if none is registered.

Overrides:

timer in class MetricRegistry

Parameters:

name - the name of the metric

Returns:

a new or pre-existing Timer

gauge

public <T extends Gauge> T gauge(MetricName name)

Return the Gauge registered under this name; or create and register a new SettableGauge if none is registered.

Overrides:

gauge in class MetricRegistry

Parameters:

name - the name of the metric

Returns:

a pre-existing Gauge or a new SettableGauge

Since:

4.2

timer

public Timer timer(MetricName name,
                   MetricRegistry.MetricSupplier<Timer> supplier)

Return the Timer registered under this name; or create and register a new Timer using the provided MetricSupplier if none is registered.

Overrides:

timer in class MetricRegistry

Parameters:

name - the name of the metric

supplier - a MetricSupplier that can be used to manufacture a Timer

Returns:

a new or pre-existing Timer

gauge

public <T extends Gauge> T gauge(MetricName name,
                                 MetricRegistry.MetricSupplier<T> supplier)

Return the Gauge registered under this name; or create and register a new Gauge using the provided MetricSupplier if none is registered.

Overrides:

gauge in class MetricRegistry

Parameters:

name - the name of the metric

supplier - a MetricSupplier that can be used to manufacture a Gauge

Returns:

a new or pre-existing Gauge

remove

public boolean remove(MetricName name)

Removes the metric with the given name.

Overrides:

remove in class MetricRegistry

Parameters:

name - the name of the metric

Returns:

whether or not the metric was removed

removeMatching

public void removeMatching(MetricFilter filter)

Removes all metrics which match the given filter.

Overrides:

removeMatching in class MetricRegistry

Parameters:

filter - a filter

addListener

public void addListener(MetricRegistryListener listener)

Adds a MetricRegistryListener to a collection of listeners that will be notified on metric creation. Listeners will be notified in the order in which they are added.

N.B.: The listener will be notified of all existing metrics when it first registers.

Overrides:

addListener in class MetricRegistry

Parameters:

listener - the listener that will be notified

removeListener

public void removeListener(MetricRegistryListener listener)

Removes a MetricRegistryListener from this registry's collection of listeners.

Overrides:

removeListener in class MetricRegistry

Parameters:

listener - the listener that will be removed

getNames

public SortedSet<MetricName> getNames()

Returns a set of the names of all the metrics in the registry.

Overrides:

getNames in class MetricRegistry

Returns:

the names of all the metrics

getGauges

public SortedMap<MetricName,Gauge<?>> getGauges()

Returns a map of all the gauges in the registry and their names.

Overrides:

getGauges in class MetricRegistry

Returns:

all the gauges in the registry

getGauges

public SortedMap<MetricName,Gauge<?>> getGauges(MetricFilter filter)

Returns a map of all the gauges in the registry and their names which match the given filter.

Overrides:

getGauges in class MetricRegistry

Parameters:

filter - the metric filter to match

Returns:

all the gauges in the registry

getCounters

public SortedMap<MetricName,Counter> getCounters()

Returns a map of all the counters in the registry and their names.

Overrides:

getCounters in class MetricRegistry

Returns:

all the counters in the registry

getCounters

public SortedMap<MetricName,Counter> getCounters(MetricFilter filter)

Returns a map of all the counters in the registry and their names which match the given filter.

Overrides:

getCounters in class MetricRegistry

Parameters:

filter - the metric filter to match

Returns:

all the counters in the registry

getHistograms

public SortedMap<MetricName,Histogram> getHistograms()

Returns a map of all the histograms in the registry and their names.

Overrides:

getHistograms in class MetricRegistry

Returns:

all the histograms in the registry

getHistograms

public SortedMap<MetricName,Histogram> getHistograms(MetricFilter filter)

Returns a map of all the histograms in the registry and their names which match the given filter.

Overrides:

getHistograms in class MetricRegistry

Parameters:

filter - the metric filter to match

Returns:

all the histograms in the registry

getMeters

public SortedMap<MetricName,Meter> getMeters()

Returns a map of all the meters in the registry and their names.

Overrides:

getMeters in class MetricRegistry

Returns:

all the meters in the registry

getMeters

public SortedMap<MetricName,Meter> getMeters(MetricFilter filter)

Returns a map of all the meters in the registry and their names which match the given filter.

Overrides:

getMeters in class MetricRegistry

Parameters:

filter - the metric filter to match

Returns:

all the meters in the registry

getTimers

public SortedMap<MetricName,Timer> getTimers()

Returns a map of all the timers in the registry and their names.

Overrides:

getTimers in class MetricRegistry

Returns:

all the timers in the registry

getTimers

public SortedMap<MetricName,Timer> getTimers(MetricFilter filter)

Returns a map of all the timers in the registry and their names which match the given filter.

Overrides:

getTimers in class MetricRegistry

Parameters:

filter - the metric filter to match

Returns:

all the timers in the registry

registerAll

public void registerAll(MetricName prefix,
                        MetricSet metrics)
                 throws IllegalArgumentException

Overrides:

registerAll in class MetricRegistry

Throws:

IllegalArgumentException

register

public <T extends Metric> T register(MetricName name,
                                     T metric)
                              throws IllegalArgumentException

Given a Metric, registers it under the given name.

Overrides:

register in class MetricRegistry

Type Parameters:

T - the type of the metric

Parameters:

name - the name of the metric

metric - the metric

Returns:

metric

Throws:

IllegalArgumentException - if the name is already registered or metric variable is null

getMetrics

public Map<MetricName,Metric> getMetrics()

A map of metric names to metrics.

Specified by:

getMetrics in interface MetricSet

Overrides:

getMetrics in class MetricRegistry

Returns:

the metrics