io.opentelemetry.api.metrics.LongUpDownCounterBuilder Maven / Gradle / Ivy
/*
* Copyright The OpenTelemetry Authors
* SPDX-License-Identifier: Apache-2.0
*/
package io.opentelemetry.api.metrics;
import java.util.function.Consumer;
/** Builder class for {@link LongUpDownCounter}. */
public interface LongUpDownCounterBuilder {
/**
* Sets the description for this instrument.
*
* Description strings should follow the instrument description rules:
* https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/metrics/api.md#instrument-description
*/
LongUpDownCounterBuilder setDescription(String description);
/**
* Sets the unit of measure for this instrument.
*
*
Unit strings should follow the instrument unit rules:
* https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/metrics/api.md#instrument-unit
*/
LongUpDownCounterBuilder setUnit(String unit);
/** Sets the counter for recording {@code double} values. */
DoubleUpDownCounterBuilder ofDoubles();
/**
* Builds and returns a {@code LongUpDownCounter} with the desired options.
*
* @return a {@code LongUpDownCounter} with the desired options.
*/
LongUpDownCounter build();
/**
* Builds this asynchronous instrument with the given callback.
*
*
The callback will only be called when the {@link Meter} is being observed.
*
* @param callback A state-capturing callback used to observe values on-demand.
*/
void buildWithCallback(Consumer callback);
}