io.prometheus.client

Class Collector

java.lang.Object

io.prometheus.client.Collector

Direct Known Subclasses:

SimpleCollector

public abstract class Collector
extends Object

A collector for a set of metrics.

Normal users should use Gauge, Counter and Summary.

Subclasssing Collector is for advanced uses, such as proxying metrics from another monitoring system. It is it the responsibility of subclasses to ensure they produce valid metrics.

See Also:

Exposition formats.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Collector.MetricFamilySamples A metric, and all of it's samples.
static class	Collector.Type

Field Summary

Fields

Modifier and Type	Field and Description
protected static Pattern	METRIC_LABEL_NAME_RE
protected static Pattern	METRIC_NAME_RE
static double	MILLISECONDS_PER_SECOND Number of milliseconds in a second.
static double	NANOSECONDS_PER_SECOND Number of nanoseconds in a second.
protected static Pattern	RESERVED_METRIC_LABEL_NAME_RE

Constructor Summary

Constructors

Constructor and Description
Collector()

Method Summary

Methods

Modifier and Type	Method and Description
protected static void	checkMetricLabelName(String name) Throw an exception if the metric label name is invalid.
protected static void	checkMetricName(String name) Throw an exception if the metric name is invalid.
abstract List<Collector.MetricFamilySamples>	collect() Return all of the metrics of this Collector.
static String	doubleToGoString(double d) Convert a double to it's string representation in Go.
<T extends Collector> T	register() Register the Collector with the default registry.
<T extends Collector> T	register(CollectorRegistry registry) Register the Collector with the given registry.

Methods inherited from class java.lang.Object

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

Field Detail

NANOSECONDS_PER_SECOND

public static final double NANOSECONDS_PER_SECOND

Number of nanoseconds in a second.

See Also:

Constant Field Values

MILLISECONDS_PER_SECOND

public static final double MILLISECONDS_PER_SECOND

Number of milliseconds in a second.

See Also:

Constant Field Values

METRIC_NAME_RE

protected static final Pattern METRIC_NAME_RE

METRIC_LABEL_NAME_RE

protected static final Pattern METRIC_LABEL_NAME_RE

RESERVED_METRIC_LABEL_NAME_RE

protected static final Pattern RESERVED_METRIC_LABEL_NAME_RE

Constructor Detail

Collector

public Collector()

Method Detail

collect

public abstract List<Collector.MetricFamilySamples> collect()

Return all of the metrics of this Collector.

register

public <T extends Collector> T register()

Register the Collector with the default registry.

register

public <T extends Collector> T register(CollectorRegistry registry)

Register the Collector with the given registry.

checkMetricName

protected static void checkMetricName(String name)

Throw an exception if the metric name is invalid.

checkMetricLabelName

protected static void checkMetricLabelName(String name)

Throw an exception if the metric label name is invalid.

doubleToGoString

public static String doubleToGoString(double d)

Convert a double to it's string representation in Go.