org.apache.rocketmq.shaded.io.opentelemetry.sdk.metrics.internal.instrument.BoundLongUpDownCounter Maven / Gradle / Ivy
/*
* Copyright The OpenTelemetry Authors
* SPDX-License-Identifier: Apache-2.0
*/
package org.apache.rocketmq.shaded.io.opentelemetry.sdk.metrics.internal.instrument;
import org.apache.rocketmq.shaded.io.opentelemetry.api.metrics.LongUpDownCounter;
import org.apache.rocketmq.shaded.io.opentelemetry.context.Context;
import javax.annotation.concurrent.ThreadSafe;
/**
* An up-down-counter instrument with pre-bound attributes.
*
* This class is internal and is hence not for public use. Its APIs are unstable and can change
* at any time.
*/
@ThreadSafe
public interface BoundLongUpDownCounter {
/**
* Records a value with pre-bound attributes.
*
*
Note: This may use {@code Context.current()} to pull the context associated with this
* measurement.
*
* @param value The increment amount. May be positive, negative or zero.
*/
void add(long value);
/**
* Records a value with a pre-bound attributes.
*
* @param value The increment amount. May be positive, negative or zero.
* @param context The explicit context to associate with this measurement.
*/
void add(long value, Context context);
/**
* Unbinds the current bound instance from the {@link LongUpDownCounter}.
*
*
After this method returns the current instance is considered invalid (not being managed by
* the instrument). This frees any reserved memory.
*/
void unbind();
}