MetricRegistry (Metrics Core 3.1.5 API)

java.lang.Object
- com.codahale.metrics.MetricRegistry

All Implemented Interfaces:

Metric, MetricSet
```
public class MetricRegistry
extends Object
implements MetricSet
```
A registry of metric instances.

Constructor Summary

Constructors
Constructor and Description

MetricRegistry()
Creates a new MetricRegistry.

Constructors
Constructor and Description
`MetricRegistry()` Creates a new `MetricRegistry`.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addListener(MetricRegistryListener listener)` Adds a `MetricRegistryListener` to a collection of listeners that will be notified on metric creation.
`protected ConcurrentMap<String,Metric>`	`buildMap()` Creates a new `ConcurrentMap` implementation for use inside the registry.
`Counter`	`counter(String name)` Return the `Counter` registered under this name; or create and register a new `Counter` if none is registered.
`SortedMap<String,Counter>`	`getCounters()` Returns a map of all the counters in the registry and their names.
`SortedMap<String,Counter>`	`getCounters(MetricFilter filter)` Returns a map of all the counters in the registry and their names which match the given filter.
`SortedMap<String,Gauge>`	`getGauges()` Returns a map of all the gauges in the registry and their names.
`SortedMap<String,Gauge>`	`getGauges(MetricFilter filter)` Returns a map of all the gauges in the registry and their names which match the given filter.
`SortedMap<String,Histogram>`	`getHistograms()` Returns a map of all the histograms in the registry and their names.
`SortedMap<String,Histogram>`	`getHistograms(MetricFilter filter)` Returns a map of all the histograms in the registry and their names which match the given filter.
`SortedMap<String,Meter>`	`getMeters()` Returns a map of all the meters in the registry and their names.
`SortedMap<String,Meter>`	`getMeters(MetricFilter filter)` Returns a map of all the meters in the registry and their names which match the given filter.
`Map<String,Metric>`	`getMetrics()` A map of metric names to metrics.
`SortedSet<String>`	`getNames()` Returns a set of the names of all the metrics in the registry.
`SortedMap<String,Timer>`	`getTimers()` Returns a map of all the timers in the registry and their names.
`SortedMap<String,Timer>`	`getTimers(MetricFilter filter)` Returns a map of all the timers in the registry and their names which match the given filter.
`Histogram`	`histogram(String name)` Return the `Histogram` registered under this name; or create and register a new `Histogram` if none is registered.
`Meter`	`meter(String name)` Return the `Meter` registered under this name; or create and register a new `Meter` if none is registered.
`static String`	`name(Class<?> klass, String... names)` Concatenates a class name and elements to form a dotted name, eliding any null values or empty strings.
`static String`	`name(String name, String... names)` Concatenates elements to form a dotted name, eliding any null values or empty strings.
`<T extends Metric> T`	`register(String name, T metric)` Given a `Metric`, registers it under the given name.
`void`	`registerAll(MetricSet metrics)` Given a metric set, registers them.
`boolean`	`remove(String 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(String name)` Return the `Timer` registered under this name; or create and register a new `Timer` if none is registered.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - MetricRegistry
```
public MetricRegistry()
```
    Creates a new MetricRegistry.
- Method Detail
  - name
```
public static String name(String name,
                          String... names)
```
    Concatenates elements to form a dotted name, eliding any null values or empty strings.
    
    Parameters:
    
    name - the first element of the name
    
    names - the remaining elements of the name
    
    Returns:
    
    name and names concatenated by periods
  - name
```
public static String name(Class<?> klass,
                          String... names)
```
    Concatenates a class name and elements to form a dotted name, eliding any null values or empty strings.
    
    Parameters:
    
    klass - the first element of the name
    
    names - the remaining elements of the name
    
    Returns:
    
    klass and names concatenated by periods
  - buildMap
```
protected ConcurrentMap<String,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.
    
    Returns:
    
    a new ConcurrentMap
  - register
```
public <T extends Metric> T register(String name,
                                     T metric)
                              throws IllegalArgumentException
```
    Given a Metric, registers it under the given name.
    
    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
  - registerAll
```
public void registerAll(MetricSet metrics)
                 throws IllegalArgumentException
```
    Given a metric set, registers them.
    
    Parameters:
    
    metrics - a set of metrics
    
    Throws:
    
    IllegalArgumentException - if any of the names are already registered
  - counter
```
public Counter counter(String name)
```
    Return the Counter registered under this name; or create and register a new Counter if none is registered.
    
    Parameters:
    
    name - the name of the metric
    
    Returns:
    
    a new or pre-existing Counter
  - histogram
```
public Histogram histogram(String name)
```
    Return the Histogram registered under this name; or create and register a new Histogram if none is registered.
    
    Parameters:
    
    name - the name of the metric
    
    Returns:
    
    a new or pre-existing Histogram
  - meter
```
public Meter meter(String name)
```
    Return the Meter registered under this name; or create and register a new Meter if none is registered.
    
    Parameters:
    
    name - the name of the metric
    
    Returns:
    
    a new or pre-existing Meter
  - timer
```
public Timer timer(String name)
```
    Return the Timer registered under this name; or create and register a new Timer if none is registered.
    
    Parameters:
    
    name - the name of the metric
    
    Returns:
    
    a new or pre-existing Timer
  - remove
```
public boolean remove(String name)
```
    Removes the metric with the given name.
    
    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.
    
    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.
    
    Parameters:
    
    listener - the listener that will be notified
  - removeListener
```
public void removeListener(MetricRegistryListener listener)
```
    Removes a MetricRegistryListener from this registry's collection of listeners.
    
    Parameters:
    
    listener - the listener that will be removed
  - getNames
```
public SortedSet<String> getNames()
```
    Returns a set of the names of all the metrics in the registry.
    
    Returns:
    
    the names of all the metrics
  - getGauges
```
public SortedMap<String,Gauge> getGauges()
```
    Returns a map of all the gauges in the registry and their names.
    
    Returns:
    
    all the gauges in the registry
  - getGauges
```
public SortedMap<String,Gauge> getGauges(MetricFilter filter)
```
    Returns a map of all the gauges in the registry and their names which match the given filter.
    
    Parameters:
    
    filter - the metric filter to match
    
    Returns:
    
    all the gauges in the registry
  - getCounters
```
public SortedMap<String,Counter> getCounters()
```
    Returns a map of all the counters in the registry and their names.
    
    Returns:
    
    all the counters in the registry
  - getCounters
```
public SortedMap<String,Counter> getCounters(MetricFilter filter)
```
    Returns a map of all the counters in the registry and their names which match the given filter.
    
    Parameters:
    
    filter - the metric filter to match
    
    Returns:
    
    all the counters in the registry
  - getHistograms
```
public SortedMap<String,Histogram> getHistograms()
```
    Returns a map of all the histograms in the registry and their names.
    
    Returns:
    
    all the histograms in the registry
  - getHistograms
```
public SortedMap<String,Histogram> getHistograms(MetricFilter filter)
```
    Returns a map of all the histograms in the registry and their names which match the given filter.
    
    Parameters:
    
    filter - the metric filter to match
    
    Returns:
    
    all the histograms in the registry
  - getMeters
```
public SortedMap<String,Meter> getMeters()
```
    Returns a map of all the meters in the registry and their names.
    
    Returns:
    
    all the meters in the registry
  - getMeters
```
public SortedMap<String,Meter> getMeters(MetricFilter filter)
```
    Returns a map of all the meters in the registry and their names which match the given filter.
    
    Parameters:
    
    filter - the metric filter to match
    
    Returns:
    
    all the meters in the registry
  - getTimers
```
public SortedMap<String,Timer> getTimers()
```
    Returns a map of all the timers in the registry and their names.
    
    Returns:
    
    all the timers in the registry
  - getTimers
```
public SortedMap<String,Timer> getTimers(MetricFilter filter)
```
    Returns a map of all the timers in the registry and their names which match the given filter.
    
    Parameters:
    
    filter - the metric filter to match
    
    Returns:
    
    all the timers in the registry
  - getMetrics
```
public Map<String,Metric> getMetrics()
```
    Description copied from interface: MetricSet
    
    A map of metric names to metrics.
    
    Specified by:
    
    getMetrics in interface MetricSet
    
    Returns:
    
    the metrics

Class MetricRegistry

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

MetricRegistry

Method Detail

name

name

buildMap

register

registerAll

counter

histogram

meter

timer

remove

removeMatching

addListener

removeListener

getNames

getGauges

getGauges

getCounters

getCounters

getHistograms

getHistograms

getMeters

getMeters

getTimers

getTimers

getMetrics