com.aliyun.oss.shade.io.opentelemetry.api.metrics.LongHistogramBuilder Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of aliyun-sdk-oss-shade Show documentation

The Aliyun OSS SDK for Java used for accessing Aliyun Object Storage Service, includes all service and dependent JARs.

The newest version!

/*
 * Copyright The OpenTelemetry Authors
 * SPDX-License-Identifier: Apache-2.0
 */

package io.opentelemetry.api.metrics;

import java.util.List;

/**
 * Builder class for {@link LongHistogram}.
 *
 * @since 1.10.0
 */
public interface LongHistogramBuilder {
  /**
   * Sets the description for this instrument.
   *
   * @param description The description.
   * @see Instrument
   *     Description
   */
  LongHistogramBuilder setDescription(String description);

  /**
   * Sets the unit of measure for this instrument.
   *
   * @param unit The unit. Instrument units must be 63 or fewer ASCII characters.
   * @see Instrument
   *     Unit
   */
  LongHistogramBuilder setUnit(String unit);

  /**
   * Set the explicit bucket buckets boundaries advice, which suggests the recommended set of
   * explicit bucket boundaries for this histogram.
   *
   * @param bucketBoundaries The explicit bucket boundaries advice.
   * @see Explicit
   *     bucket boundaries advisory parameter
   * @since 1.32.0
   */
  default LongHistogramBuilder setExplicitBucketBoundariesAdvice(List bucketBoundaries) {
    return this;
  }

  /**
   * Builds and returns a Histogram instrument with the configuration.
   *
   * @return The Histogram instrument.
   */
  LongHistogram build();
}