Class ClassicHistogramBuckets

java.lang.Object

io.prometheus.metrics.model.snapshots.ClassicHistogramBuckets

All Implemented Interfaces:

Iterable<ClassicHistogramBucket>

public class ClassicHistogramBuckets
extends Object
implements Iterable<ClassicHistogramBucket>

Immutable container for histogram buckets with fixed bucket boundaries. Note that the counts are not cumulative.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ClassicHistogramBuckets.Builder

Field Summary

Fields

Modifier and Type	Field	Description
private final long[]	counts
static final ClassicHistogramBuckets	EMPTY	Used in native histograms to indicate that no classic histogram buckets are present.
private final double[]	upperBounds

Constructor Summary

Constructors

Modifier	Constructor	Description
private	ClassicHistogramBuckets(double[] upperBounds, long[] counts)

Method Summary

Modifier and Type	Method	Description
private List<ClassicHistogramBucket>	asList()
static ClassicHistogramBuckets.Builder	builder()	To create new ClassicHistogramBuckets, you can either use one of the static of(...) methods, or use builder().
long	getCount(int i)	The count is not cumulative.
double	getUpperBound(int i)
boolean	isEmpty()
Iterator<ClassicHistogramBucket>	iterator()
static ClassicHistogramBuckets	of(double[] upperBounds, long[] counts)	To create new ClassicHistogramBuckets, you can either use one of the static of(...) methods, or use builder().
static ClassicHistogramBuckets	of(double[] upperBounds, Number[] counts)	To create new ClassicHistogramBuckets, you can either use one of the static of(...) methods, or use builder().
static ClassicHistogramBuckets	of(List<Double> upperBounds, List<? extends Number> counts)	To create new ClassicHistogramBuckets, you can either use one of the static of(...) methods, or use builder().
int	size()
private static void	sort(double[] upperBounds, long[] counts)
private static void	sortAndValidate(double[] upperBounds, long[] counts)
Stream<ClassicHistogramBucket>	stream()
private static void	swap(int i, int j, double[] upperBounds, long[] counts)
private static void	validate(double[] upperBounds, long[] counts)

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface Iterable

forEach, spliterator

Field Details

EMPTY

public static final ClassicHistogramBuckets EMPTY

Used in native histograms to indicate that no classic histogram buckets are present.

upperBounds

private final double[] upperBounds

counts

private final long[] counts

Constructor Details

ClassicHistogramBuckets

private ClassicHistogramBuckets(double[] upperBounds,
 long[] counts)

Method Details

of

public static ClassicHistogramBuckets of(List<Double> upperBounds,
 List<? extends Number> counts)

To create new ClassicHistogramBuckets, you can either use one of the static of(...) methods, or use builder().

This method will create a copy of upperBounds and counts.

Parameters:

upperBounds - must have the same length as counts. Must not contain duplicates. Must contain at least Double.POSITIVE_INFINITY for the +Inf bucket. An upper bound must not be Double.NaN. The upperBounds array does not need to be sorted.

counts - must have the same length as upperBounds. The entry at index i is the count for the upperBounds at index i. For each count, Number.longValue() is called to get the value. Counts are not cumulative. Counts must not be negative.

of

public static ClassicHistogramBuckets of(double[] upperBounds,
 Number[] counts)

To create new ClassicHistogramBuckets, you can either use one of the static of(...) methods, or use builder().

This method will create a copy of upperBounds and counts.

Parameters:

upperBounds - must have the same length as counts. Must not contain duplicates. Must contain at least Double.POSITIVE_INFINITY for the +Inf bucket. An upper bound must not be Double.NaN. The upperBounds array does not need to be sorted.

counts - must have the same length as upperBounds. The entry at index i is the count for the upperBounds at index i. For each count, Number.longValue() is called to get the value. Counts are not cumulative. Counts must not be negative.

of

public static ClassicHistogramBuckets of(double[] upperBounds,
 long[] counts)

To create new ClassicHistogramBuckets, you can either use one of the static of(...) methods, or use builder().

This method will create a copy of upperBounds and counts.

Parameters:

upperBounds - must have the same length as counts. Must not contain duplicates. Must contain at least Double.POSITIVE_INFINITY for the +Inf bucket. An upper bound must not be Double.NaN. The upperBounds array does not need to be sorted.

counts - must have the same length as upperBounds. The entry at index i is the count for the upperBounds at index i. Counts are not cumulative. Counts must not be negative.

sortAndValidate

private static void sortAndValidate(double[] upperBounds,
 long[] counts)

sort

private static void sort(double[] upperBounds,
 long[] counts)

swap

private static void swap(int i,
 int j,
 double[] upperBounds,
 long[] counts)

validate

private static void validate(double[] upperBounds,
 long[] counts)

size

public int size()

getUpperBound

public double getUpperBound(int i)

getCount

public long getCount(int i)

The count is not cumulative.

isEmpty

public boolean isEmpty()

asList

private List<ClassicHistogramBucket> asList()

iterator

public Iterator<ClassicHistogramBucket> iterator()

Specified by:

iterator in interface Iterable<ClassicHistogramBucket>

stream

public Stream<ClassicHistogramBucket> stream()

builder

public static ClassicHistogramBuckets.Builder builder()

To create new ClassicHistogramBuckets, you can either use one of the static of(...) methods, or use builder().