Class Gauge
- All Implemented Interfaces:
DataPoint
,GaugeDataPoint
,TimerApi
,Collector
Gauge metric.
Example usage:
Gauge currentActiveUsers = Gauge.builder()
.name("current_active_users")
.help("Number of users that are currently active")
.labelNames("region")
.register();
public void login(String region) {
currentActiveUsers.labelValues(region).inc();
// perform login
}
public void logout(String region) {
currentActiveUsers.labelValues(region).dec();
// perform logout
}
-
Nested Class Summary
-
Method Summary
Modifier and TypeMethodDescriptionstatic Gauge.Builder
builder()
static Gauge.Builder
builder
(PrometheusProperties config) void
clear()
Reset the metric (remove all data points).collect()
Called when the Prometheus server scrapes metrics.double
get()
Get the current value.void
inc
(double amount) Addamount
.void
incWithExemplar
(double amount, Labels labels) Addamount
, and create a custom exemplar with the given labels.void
initLabelValues
(String... labelValues) Initialize label values.labelValues
(String... labelValues) void
Remove the data point with the given label values.void
set
(double value) Set the gauge tovalue
.void
setWithExemplar
(double value, Labels labels) Set the gauge tovalue
, and create a custom exemplar with the given labels.Methods inherited from class MetricWithFixedMetadata
getPrometheusName
Methods inherited from class Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface GaugeDataPoint
dec, dec, decWithExemplar, decWithExemplar, inc, incWithExemplar, startTimer
Methods inherited from interface TimerApi
time, time, timeChecked
-
Method Details
-
inc
Addamount
.- Specified by:
inc
in interfaceGaugeDataPoint
-
get
Get the current value.- Specified by:
get
in interfaceGaugeDataPoint
-
incWithExemplar
Addamount
, and create a custom exemplar with the given labels.- Specified by:
incWithExemplar
in interfaceGaugeDataPoint
-
set
Set the gauge tovalue
.- Specified by:
set
in interfaceGaugeDataPoint
-
setWithExemplar
Set the gauge tovalue
, and create a custom exemplar with the given labels.- Specified by:
setWithExemplar
in interfaceGaugeDataPoint
-
collect
Called when the Prometheus server scrapes metrics. -
builder
-
builder
-
initLabelValues
Initialize label values.Example: Imagine you have a counter for payments as follows
payment_transactions_total{payment_type="credit card"} 7.0 payment_transactions_total{payment_type="paypal"} 3.0
Now, the data points for thepayment_type
label values get initialized when they are first used, i.e. the first time you call
the data point with labelcounter.labelValues("paypal").inc();
payment_type="paypal"
will go from non-existent to having value1.0
.In some cases this is confusing, and you want to have data points initialized on application start with an initial value of
0.0
:payment_transactions_total{payment_type="credit card"} 0.0 payment_transactions_total{payment_type="paypal"} 0.0
initLabelValues(...)
can be used to initialize label value, so that the data points show up in the exposition format with an initial value of zero. -
labelValues
-
remove
Remove the data point with the given label values. See https://prometheus.io/docs/instrumenting/writing_clientlibs/#labels. -
clear
public void clear()Reset the metric (remove all data points).
-