com.aliyun.openservices.shade.io.opentelemetry.api.metrics.LongCounter Maven / Gradle / Ivy
/*
* Copyright The OpenTelemetry Authors
* SPDX-License-Identifier: Apache-2.0
*/
package com.aliyun.openservices.shade.com.aliyun.openservices.shade.io.opentelemetry.api.metrics;
import com.aliyun.openservices.shade.com.aliyun.openservices.shade.io.opentelemetry.api.common.Attributes;
import com.aliyun.openservices.shade.com.aliyun.openservices.shade.io.opentelemetry.context.Context;
import javax.annotation.concurrent.ThreadSafe;
/**
* A counter instrument that records {@code long} values.
*
* Counters only allow adding positive values, and guarantee the resulting metrics will be
* always-increasing monotonic sums.
*/
@ThreadSafe
public interface LongCounter {
/**
* Records a value.
*
*
Note: This may use {@code Context.current()} to pull the context associated with this
* measurement.
*
* @param value The increment amount. MUST be non-negative.
*/
void add(long value);
/**
* Records a value with a set of attributes.
*
*
Note: This may use {@code Context.current()} to pull the context associated with this
* measurement.
*
* @param value The increment amount. MUST be non-negative.
* @param attributes A set of attributes to associate with the count.
*/
void add(long value, Attributes attributes);
/**
* Records a value with a set of attributes.
*
* @param value The increment amount. MUST be non-negative.
* @param attributes A set of attributes to associate with the count.
* @param context The explicit context to associate with this measurement.
*/
void add(long value, Attributes attributes, Context context);
}