org.springframework.boot.actuate.metrics.export

Class AbstractMetricExporter

java.lang.Object

org.springframework.boot.actuate.metrics.export.AbstractMetricExporter

All Implemented Interfaces:

Exporter

Direct Known Subclasses:

MetricCopyExporter, PrefixMetricGroupExporter, RichGaugeExporter

public abstract class AbstractMetricExporter
extends Object
implements Exporter

Base class for metric exporters that have common features, principally a prefix for exported metrics and filtering by timestamp (so only new values are included in the export).

Author:

Dave Syer

Constructor Summary

Constructors

Constructor and Description
AbstractMetricExporter(String prefix)

Method Summary

Methods

Modifier and Type	Method and Description
void	export() Export metric data.
protected Iterable<String>	groups() Generate a group of metrics to iterate over in the form of a set of Strings (e.g.
protected abstract Iterable<Metric<?>>	next(String group) Get the next group of metrics to write.
void	setEarliestTimestamp(Date earliestTimestamp) The earliest time for which data will be exported.
void	setIgnoreTimestamps(boolean ignoreTimestamps) Ignore timestamps (export all metrics).
protected abstract void	write(String group, Collection<Metric<?>> values) Write the values associated with a group.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractMetricExporter

public AbstractMetricExporter(String prefix)

Method Detail

setEarliestTimestamp

public void setEarliestTimestamp(Date earliestTimestamp)

The earliest time for which data will be exported.

Parameters:

earliestTimestamp - the timestamp to set

setIgnoreTimestamps

public void setIgnoreTimestamps(boolean ignoreTimestamps)

Ignore timestamps (export all metrics).

Parameters:

ignoreTimestamps - the flag to set

export

public void export()

Description copied from interface: Exporter

Export metric data.

Specified by:

export in interface Exporter

groups

protected Iterable<String> groups()

Generate a group of metrics to iterate over in the form of a set of Strings (e.g. prefixes). If the metrics to be exported partition into groups identified by a String, subclasses should override this method. Otherwise the default should be fine (iteration over all metrics).

Returns:

groups of metrics to iterate over (default singleton empty string)

write

protected abstract void write(String group,
         Collection<Metric<?>> values)

Write the values associated with a group.

Parameters:

group - the group to write

values - the values to write

next

protected abstract Iterable<Metric<?>> next(String group)

Get the next group of metrics to write.

Parameters:

group - the group name to write

Returns:

some metrics to write