Package io.prometheus.client

Class Collector

java.lang.Object

io.prometheus.client.Collector

Direct Known Subclasses:

BufferPoolsExports, CacheMetricsCollector, ClassLoadingExports, GarbageCollectorExports, JettyStatisticsCollector, MemoryAllocationExports, MemoryPoolsExports, QueuedThreadPoolStatisticsCollector, SimpleCollector, StandardExports, ThreadExports, VersionInfoExports

public abstract class Collector
extends java.lang.Object

A collector for a set of metrics.

Normal users should use Gauge, Counter, Summary and Histogram.

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	Description
static interface	Collector.Describable
static class	Collector.MetricFamilySamples	A metric, and all of its samples.
static class	Collector.Type

Field Summary

Fields

Modifier and Type	Field	Description
private static java.util.regex.Pattern	METRIC_LABEL_NAME_RE
private static java.util.regex.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.
private static java.util.regex.Pattern	RESERVED_METRIC_LABEL_NAME_RE
private static java.util.regex.Pattern	SANITIZE_BODY_PATTERN
private static java.util.regex.Pattern	SANITIZE_PREFIX_PATTERN

Constructor Summary

Constructors

Constructor	Description
Collector()

Method Summary

Modifier and Type	Method	Description
protected static void	checkMetricLabelName(java.lang.String name)	Throw an exception if the metric label name is invalid.
protected static void	checkMetricName(java.lang.String name)	Throw an exception if the metric name is invalid.
abstract java.util.List<Collector.MetricFamilySamples>	collect()	Return all of the metrics of this Collector.
static java.lang.String	doubleToGoString(double d)	Convert a double to its 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.
static java.lang.String	sanitizeMetricName(java.lang.String metricName)	Sanitize metric name

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

private static final java.util.regex.Pattern METRIC_NAME_RE

METRIC_LABEL_NAME_RE

private static final java.util.regex.Pattern METRIC_LABEL_NAME_RE

RESERVED_METRIC_LABEL_NAME_RE

private static final java.util.regex.Pattern RESERVED_METRIC_LABEL_NAME_RE

SANITIZE_PREFIX_PATTERN

private static final java.util.regex.Pattern SANITIZE_PREFIX_PATTERN

SANITIZE_BODY_PATTERN

private static final java.util.regex.Pattern SANITIZE_BODY_PATTERN

Constructor Detail

Collector

public Collector()

Method Detail

collect

public abstract java.util.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(java.lang.String name)

Throw an exception if the metric name is invalid.

sanitizeMetricName

public static java.lang.String sanitizeMetricName(java.lang.String metricName)

Sanitize metric name

checkMetricLabelName

protected static void checkMetricLabelName(java.lang.String name)

Throw an exception if the metric label name is invalid.

doubleToGoString

public static java.lang.String doubleToGoString(double d)

Convert a double to its string representation in Go.