com.netflix.spectator.api

Class ExtendedRegistry

java.lang.Object

com.netflix.spectator.api.ExtendedRegistry

All Implemented Interfaces:

Registry, java.lang.Iterable<Meter>

Deprecated.

This class was used prior to java 8 for adding extension methods to the registry without breaking all classes implementing the interface. The extension methods have now been moved to Registry interface as default methods.

@Deprecated
public final class ExtendedRegistry
extends java.lang.Object
implements Registry

Wraps a registry and provides additional helper methods to make it easier to use.

Constructor Summary

Constructors

Constructor and Description
ExtendedRegistry(Registry impl) Deprecated. Create a new instance.

Method Summary

Modifier and Type	Method and Description
Clock	clock() Deprecated. The clock used by the registry for timing events.
Counter	counter(Id id) Deprecated. Measures the rate of some activity.
Id	createId(java.lang.String name) Deprecated. Creates an identifier for a meter.
Id	createId(java.lang.String name, java.lang.Iterable<Tag> tags) Deprecated. Creates an identifier for a meter.
DistributionSummary	distributionSummary(Id id) Deprecated. Measures the rate and variation in amount for some activity.
Gauge	gauge(Id id) Deprecated. Represents a value sampled from another source.
Meter	get(Id id) Deprecated. Returns the meter associated with a given id.
java.util.Iterator<Meter>	iterator() Deprecated. Iterator for traversing the set of meters in the registry.
Gauge	maxGauge(Id id) Deprecated. Measures the maximum value recorded since the last reset.
void	register(Meter meter) Deprecated. Register a passive gauge.
java.util.concurrent.ConcurrentMap<Id,java.lang.Object>	state() Deprecated. Returns a map that can be used to associate state with the registry.
Timer	timer(Id id) Deprecated. Measures the rate and time taken for short running tasks.
java.lang.String	toString() Deprecated.
Registry	underlying() Deprecated. Returns the underlying registry implementation that is being wrapped.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.netflix.spectator.api.Registry

collectionSize, collectionSize, config, counter, counter, counter, counters, createId, createId, distributionSummaries, distributionSummary, distributionSummary, distributionSummary, gauge, gauge, gauge, gauge, gauge, gauge, gauge, gauge, gauges, longTaskTimer, longTaskTimer, longTaskTimer, longTaskTimer, mapSize, mapSize, maxGauge, maxGauge, maxGauge, measurements, methodValue, methodValue, propagate, propagate, stream, timer, timer, timer, timers, underlying

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

ExtendedRegistry

public ExtendedRegistry(Registry impl)

Deprecated.

Create a new instance.

Method Detail

underlying

public Registry underlying()

Deprecated.

Returns the underlying registry implementation that is being wrapped.

clock

public Clock clock()

Deprecated.

Description copied from interface: Registry

The clock used by the registry for timing events.

Specified by:

clock in interface Registry

createId

public Id createId(java.lang.String name)

Deprecated.

Description copied from interface: Registry

Creates an identifier for a meter. All ids passed into other calls should be created by the registry.

Specified by:

createId in interface Registry

Parameters:

name - Description of the measurement that is being collected.

createId

public Id createId(java.lang.String name,
                   java.lang.Iterable<Tag> tags)

Deprecated.

Description copied from interface: Registry

Creates an identifier for a meter. All ids passed into other calls should be created by the registry.

Specified by:

createId in interface Registry

Parameters:

name - Description of the measurement that is being collected.

tags - Other dimensions that can be used to classify the measurement.

register

public void register(Meter meter)

Deprecated.

Description copied from interface: Registry

Register a passive gauge. In most cases users should not use this method directly. Use one of the helper methods for working with gauges.

Specified by:

register in interface Registry

See Also:

Registry.gauge(Id, Number), Registry.gauge(Id, Object, ToDoubleFunction), Registry.collectionSize(Id, Collection), Registry.mapSize(Id, Map)

state

public java.util.concurrent.ConcurrentMap<Id,java.lang.Object> state()

Deprecated.

Description copied from interface: Registry

Returns a map that can be used to associate state with the registry. Users instrumenting their application will most likely never need to use this method. The primary use case is for building custom meter types that need some additional state beyond the core types supported by the registry. This map can be used to store the state so that the lifecycle of the data is connected to the registry. For an example, see some of the built in patterns such as LongTaskTimer.

Specified by:

state in interface Registry

counter

public Counter counter(Id id)

Deprecated.

Description copied from interface: Registry

Measures the rate of some activity. A counter is for continuously incrementing sources like the number of requests that are coming into a server.

Specified by:

counter in interface Registry

Parameters:

id - Identifier created by a call to Registry.createId(java.lang.String)

distributionSummary

public DistributionSummary distributionSummary(Id id)

Deprecated.

Description copied from interface: Registry

Measures the rate and variation in amount for some activity. For example, it could be used to get insight into the variation in response sizes for requests to a server.

Specified by:

distributionSummary in interface Registry

Parameters:

id - Identifier created by a call to Registry.createId(java.lang.String)

timer

public Timer timer(Id id)

Deprecated.

Description copied from interface: Registry

Measures the rate and time taken for short running tasks.

Specified by:

timer in interface Registry

Parameters:

id - Identifier created by a call to Registry.createId(java.lang.String)

gauge

public Gauge gauge(Id id)

Deprecated.

Description copied from interface: Registry

Represents a value sampled from another source. For example, the size of queue. The caller is responsible for sampling the value regularly and calling Gauge.set(double). Registry implementations are free to expire the gauge if it has not been updated in the last minute. If you do not want to worry about the sampling, then use PolledMeter instead.

Specified by:

gauge in interface Registry

Parameters:

id - Identifier created by a call to Registry.createId(java.lang.String)

maxGauge

public Gauge maxGauge(Id id)

Deprecated.

Description copied from interface: Registry

Measures the maximum value recorded since the last reset. For example, to measure the maximum number of concurrent requests to a service. In many cases it is better to use a Registry.distributionSummary(Id) which provides a max along with other stats for most registry implementations.

Specified by:

maxGauge in interface Registry

Parameters:

id - Identifier created by a call to Registry.createId(java.lang.String)

get

public Meter get(Id id)

Deprecated.

Description copied from interface: Registry

Returns the meter associated with a given id.

Specified by:

get in interface Registry

Parameters:

id - Identifier for the meter.

Returns:

Instance of the meter or null if there is no match.

iterator

public java.util.Iterator<Meter> iterator()

Deprecated.

Description copied from interface: Registry

Iterator for traversing the set of meters in the registry.

Specified by:

iterator in interface Registry

Specified by:

iterator in interface java.lang.Iterable<Meter>

toString

public java.lang.String toString()

Deprecated.

Overrides:

toString in class java.lang.Object