Package io.prometheus.client

Class Counter.Child

java.lang.Object

io.prometheus.client.Counter.Child

Enclosing class:

Counter

public static class Counter.Child
extends java.lang.Object

The value of a single Counter.

Warning: References to a Child become invalid after using SimpleCollector.remove(java.lang.String...) or SimpleCollector.clear(),

Field Summary

Fields

Modifier and Type	Field	Description
private long	created
private java.util.concurrent.atomic.AtomicReference<Exemplar>	exemplar
private CounterExemplarSampler	exemplarSampler
private java.lang.Boolean	exemplarsEnabled
private DoubleAdder	value

Constructor Summary

Constructors

Constructor	Description
Child()
Child(java.lang.Boolean exemplarsEnabled, CounterExemplarSampler exemplarSampler)

Method Summary

Modifier and Type	Method	Description
long	created()	Get the created time of the counter in milliseconds.
double	get()	Get the value of the counter.
private Exemplar	getExemplar()
void	inc()	Increment the counter by 1.
void	inc(double amt)	Increment the counter by the given amount.
void	incWithExemplar(double amt, java.lang.String... exemplarLabels)	Like inc(double), but additionally creates an exemplar.
void	incWithExemplar(double amt, java.util.Map<java.lang.String,java.lang.String> exemplarLabels)	Same as incWithExemplar(double, String...), but the exemplar labels are passed as a Map.
void	incWithExemplar(java.lang.String... exemplarLabels)	Same as incWithExemplar(1, exemplarLabels).
void	incWithExemplar(java.util.Map<java.lang.String,java.lang.String> exemplarLabels)	Same as incWithExemplar(1, exemplarLabels).
private Exemplar	sampleNextExemplar(double amt, Exemplar prev)
private void	updateExemplar(double amt, Exemplar userProvidedExemplar)

Methods inherited from class java.lang.Object

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

Field Detail

value

private final DoubleAdder value

created

private final long created

exemplarsEnabled

private final java.lang.Boolean exemplarsEnabled

exemplarSampler

private final CounterExemplarSampler exemplarSampler

exemplar

private final java.util.concurrent.atomic.AtomicReference<Exemplar> exemplar

Constructor Detail

Child

public Child()

Child

public Child(java.lang.Boolean exemplarsEnabled,
             CounterExemplarSampler exemplarSampler)

Method Detail

inc

public void inc()

Increment the counter by 1.

incWithExemplar

public void incWithExemplar(java.lang.String... exemplarLabels)

Same as incWithExemplar(1, exemplarLabels).

incWithExemplar

public void incWithExemplar(java.util.Map<java.lang.String,java.lang.String> exemplarLabels)

Same as incWithExemplar(1, exemplarLabels).

inc

public void inc(double amt)

Increment the counter by the given amount.

Throws:

java.lang.IllegalArgumentException - If amt is negative.

incWithExemplar

public void incWithExemplar(double amt,
                            java.lang.String... exemplarLabels)

Like inc(double), but additionally creates an exemplar.

This exemplar takes precedence over any exemplar returned by the CounterExemplarSampler configured in ExemplarConfig.

The exemplar will have amt as the value, System.currentTimeMillis() as the timestamp, and the specified labels.

Parameters:

amt - same as in inc(double)

exemplarLabels - list of name/value pairs, as documented in Exemplar(double, String...). A commonly used name is "trace_id". Calling incWithExemplar(amt) means that an exemplar without labels will be created. Calling incWithExemplar(amt, (String[]) null) is equivalent to calling inc(amt).

incWithExemplar

public void incWithExemplar(double amt,
                            java.util.Map<java.lang.String,java.lang.String> exemplarLabels)

Same as incWithExemplar(double, String...), but the exemplar labels are passed as a Map.

updateExemplar

private void updateExemplar(double amt,
                            Exemplar userProvidedExemplar)

sampleNextExemplar

private Exemplar sampleNextExemplar(double amt,
                                    Exemplar prev)

get

public double get()

Get the value of the counter.

getExemplar

private Exemplar getExemplar()

created

public long created()

Get the created time of the counter in milliseconds.