com.alipay.disruptor.collections

类 Histogram

java.lang.Object

com.alipay.disruptor.collections.Histogram

public final class Histogram
extends Object

Histogram for tracking the frequency of observations of values below interval upper bounds.

This class is useful for recording timings across a large number of observations when high performance is required.

The interval bounds are used to define the ranges of the histogram buckets. If provided bounds are [10,20,30,40,50] then there will be five buckets, accessible by index 0-4. Any value 0-10 will fall into the first interval bar, values 11-20 will fall into the second bar, and so on.

构造器概要

构造器

构造器和说明
Histogram(long[] upperBounds) Create a new Histogram with a provided list of interval bounds.

方法概要

方法

限定符和类型	方法和说明
boolean	addObservation(long value) Add an observation to the histogram and increment the counter for the interval it matches.
void	addObservations(Histogram histogram) Add observations from another Histogram into this one.
void	clear() Clear the list of interval counters
long	getCount() Count total number of recorded observations.
long	getCountAt(int index) Get the count of observations at a given index.
long	getFourNinesUpperBound() Calculate the upper bound within which 99.99% of observations fall.
long	getMax() Get the maximum observed value.
BigDecimal	getMean() Calculate the mean of all recorded observations.
long	getMin() Get the minimum observed value.
int	getSize() Size of the list of interval bars (ie: count of interval bars).
long	getTwoNinesUpperBound() Calculate the upper bound within which 99% of observations fall.
long	getUpperBoundAt(int index) Get the upper bound of an interval for an index.
long	getUpperBoundForFactor(double factor) Get the interval upper bound for a given factor of the observation population.
String	toString()

从类继承的方法 java.lang.Object

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

构造器详细资料

Histogram

public Histogram(long[] upperBounds)

Create a new Histogram with a provided list of interval bounds.

参数:

upperBounds - of the intervals. Bounds must be provided in order least to greatest, and lowest bound must be greater than or equal to 1.

抛出:

IllegalArgumentException - if any of the upper bounds are less than or equal to zero

IllegalArgumentException - if the bounds are not in order, least to greatest

方法详细资料

getSize

public int getSize()

Size of the list of interval bars (ie: count of interval bars).

返回:

size of the interval bar list.

getUpperBoundAt

public long getUpperBoundAt(int index)

Get the upper bound of an interval for an index.

参数:

index - of the upper bound.

返回:

the interval upper bound for the index.

getCountAt

public long getCountAt(int index)

Get the count of observations at a given index.

参数:

index - of the observations counter.

返回:

the count of observations at a given index.

addObservation

public boolean addObservation(long value)

Add an observation to the histogram and increment the counter for the interval it matches.

参数:

value - for the observation to be added.

返回:

return true if in the range of intervals and successfully added observation; otherwise false.

addObservations

public void addObservations(Histogram histogram)

Add observations from another Histogram into this one.

Histograms must have the same intervals.

参数:

histogram - from which to add the observation counts.

抛出:

IllegalArgumentException - if interval count or values do not match exactly

clear

public void clear()

Clear the list of interval counters

getCount

public long getCount()

Count total number of recorded observations.

返回:

the total number of recorded observations.

getMin

public long getMin()

Get the minimum observed value.

返回:

the minimum value observed.

getMax

public long getMax()

Get the maximum observed value.

返回:

the maximum of the observed values;

getMean

public BigDecimal getMean()

Calculate the mean of all recorded observations.

The mean is calculated by summing the mid points of each interval multiplied by the count for that interval, then dividing by the total count of observations. The max and min are considered for adjusting the top and bottom bin when calculating the mid point, this minimises skew if the observed values are very far away from the possible histogram values.

返回:

the mean of all recorded observations.

getTwoNinesUpperBound

public long getTwoNinesUpperBound()

Calculate the upper bound within which 99% of observations fall.

返回:

the upper bound for 99% of observations.

getFourNinesUpperBound

public long getFourNinesUpperBound()

Calculate the upper bound within which 99.99% of observations fall.

返回:

the upper bound for 99.99% of observations.

getUpperBoundForFactor

public long getUpperBoundForFactor(double factor)

Get the interval upper bound for a given factor of the observation population.

Note this does not get the actual percentile measurement, it only gets the bucket

参数:

factor - representing the size of the population.

返回:

the interval upper bound.

抛出:

IllegalArgumentException - if factor < 0.0 or factor > 1.0

toString

public String toString()

覆盖:

toString 在类中 Object