Class Counter.Child

java.lang.Object

io.prometheus.client.Counter.Child

Enclosing class:

Counter

public static class Counter.Child
extends Object

The value of a single Counter.

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

Field Summary

Fields

Modifier and Type	Field	Description
private final long	created
private final AtomicReference<Exemplar>	exemplar
private final CounterExemplarSampler	exemplarSampler
private final Boolean	exemplarsEnabled
private final DoubleAdder	value

Constructor Summary

Constructors

Constructor	Description
Child()
Child(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, String... exemplarLabels)	Like inc(double), but additionally creates an exemplar.
void	incWithExemplar(double amt, Map<String,String> exemplarLabels)	Same as incWithExemplar(double, String...), but the exemplar labels are passed as a Map.
void	incWithExemplar(String... exemplarLabels)	Same as incWithExemplar(1, exemplarLabels).
void	incWithExemplar(Map<String,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 Object

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

Field Details

value

private final DoubleAdder value

created

private final long created

exemplarsEnabled

private final Boolean exemplarsEnabled

exemplarSampler

private final CounterExemplarSampler exemplarSampler

exemplar

private final AtomicReference<Exemplar> exemplar

Constructor Details

Child

public Child()

Child

public Child(Boolean exemplarsEnabled,
 CounterExemplarSampler exemplarSampler)

Method Details

inc

public void inc()

Increment the counter by 1.

incWithExemplar

public void incWithExemplar(String... exemplarLabels)

Same as incWithExemplar(1, exemplarLabels).

incWithExemplar

public void incWithExemplar(Map<String,String> exemplarLabels)

Same as incWithExemplar(1, exemplarLabels).

inc

public void inc(double amt)

Increment the counter by the given amount.

Throws:

IllegalArgumentException - If amt is negative.

incWithExemplar

public void incWithExemplar(double amt,
 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,
 Map<String,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.