@ThreadSafe public interface LongUpDownCounter extends SynchronousInstrument<LongUpDownCounter.BoundLongUpDownCounter>
Example:
class YourClass {
private static final Meter meter = OpenTelemetry.getMeterProvider().get("my_library_name");
private static final LongUpDownCounter upDownCounter =
meter.
.longUpDownCounterBuilder("active_tasks")
.setDescription("Number of active tasks")
.setUnit("1")
.build();
// It is recommended that the API user keep a reference to a Bound Counter.
private static final BoundLongUpDownCounter someWorkBound =
upDownCounter.bind("work_name", "some_work");
void doSomeWork() {
someWorkBound.add(1);
// Your code here.
someWorkBound.add(-1);
}
}
Modifier and Type | Interface and Description |
---|---|
static interface |
LongUpDownCounter.BoundLongUpDownCounter
A
Bound Instrument for a LongUpDownCounter . |
static interface |
LongUpDownCounter.Builder
Builder class for
LongUpDownCounter . |
SynchronousInstrument.BoundInstrument
Modifier and Type | Method and Description |
---|---|
void |
add(long increment)
Adds the given
increment to the current value. |
void |
add(long increment,
Labels labels)
Adds the given
increment to the current value. |
LongUpDownCounter.BoundLongUpDownCounter |
bind(Labels labels)
Returns a
Bound Instrument associated with the specified labels. |
void add(long increment, Labels labels)
increment
to the current value.
The value added is associated with the current Context
and provided set of labels.
increment
- the value to add.labels
- the set of labels to be associated to this recording.void add(long increment)
increment
to the current value.
The value added is associated with the current Context
and empty labels.
increment
- the value to add.LongUpDownCounter.BoundLongUpDownCounter bind(Labels labels)
SynchronousInstrument
Bound Instrument
associated with the specified labels. Multiples requests
with the same set of labels may return the same Bound Instrument
instance.
It is recommended that callers keep a reference to the Bound Instrument instead of always calling this method for every operation.
bind
in interface SynchronousInstrument<LongUpDownCounter.BoundLongUpDownCounter>
labels
- the set of labels, as key-value pairs.Bound Instrument