org.springframework.boot.actuate.metrics.repository.redis

Class RedisMetricRepository

java.lang.Object

org.springframework.boot.actuate.metrics.repository.redis.RedisMetricRepository

All Implemented Interfaces:

MetricReader, MetricRepository, MetricWriter

public class RedisMetricRepository
extends Object
implements MetricRepository

A MetricRepository implementation for a redis backend. Metric values are stored as zset values plus a regular hash value for the timestamp, both against a key composed of the metric name prefixed with a constant (default "spring.metrics."). If you have multiple metrics repositories all point at the same instance of Redis, it may be useful to change the prefix to be unique (but not if you want them to contribute to the same metrics).

Author:

Dave Syer

Constructor Summary

Constructors

Constructor and Description
RedisMetricRepository(RedisConnectionFactory redisConnectionFactory)

Method Summary

Methods

Modifier and Type	Method and Description
long	count() The number of metrics known to this reader.
Iterable<Metric<?>>	findAll() Find all the metrics known to this reader.
Metric<?>	findOne(String metricName) Find an instance of the metric with the given name (usually the latest recorded value).
void	increment(Delta<?> delta) Increment the value of a metric (or decrement if the delta is negative).
void	reset(String metricName) Reset the value of a metric, usually to zero value.
void	set(Metric<?> value) Set the value of a metric.
void	setKey(String key) The redis key to use to store the index of other keys.
void	setPrefix(String prefix) The prefix for all metrics keys.

Methods inherited from class java.lang.Object

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

Constructor Detail

RedisMetricRepository

public RedisMetricRepository(RedisConnectionFactory redisConnectionFactory)

Method Detail

setPrefix

public void setPrefix(String prefix)

The prefix for all metrics keys.

Parameters:

prefix - the prefix to set for all metrics keys

setKey

public void setKey(String key)

The redis key to use to store the index of other keys. The redis store will hold a zset under this key. Defaults to "keys.spring.metrics". Read operations, especially findAll() and count(), will be much more efficient if the key is unique to the prefix of this repository.

Parameters:

key - the key to set

findOne

public Metric<?> findOne(String metricName)

Description copied from interface: MetricReader

Find an instance of the metric with the given name (usually the latest recorded value).

Specified by:

findOne in interface MetricReader

Parameters:

metricName - the name of the metric to find

Returns:

a metric value or null if there are none with that name

findAll

public Iterable<Metric<?>> findAll()

Description copied from interface: MetricReader

Find all the metrics known to this reader.

Specified by:

findAll in interface MetricReader

Returns:

all instances of metrics known to this reader

count

public long count()

Description copied from interface: MetricReader

The number of metrics known to this reader.

Specified by:

count in interface MetricReader

Returns:

the number of metrics

increment

public void increment(Delta<?> delta)

Description copied from interface: MetricWriter

Increment the value of a metric (or decrement if the delta is negative). The name of the delta is the name of the metric to increment.

Specified by:

increment in interface MetricWriter

Parameters:

delta - the amount to increment by

set

public void set(Metric<?> value)

Description copied from interface: MetricWriter

Set the value of a metric.

Specified by:

set in interface MetricWriter

reset

public void reset(String metricName)

Description copied from interface: MetricWriter

Reset the value of a metric, usually to zero value. Implementations can discard the old values if desired, but may choose not to.

Specified by:

reset in interface MetricWriter

Parameters:

metricName - the name to reset