com.netflix.stats.distribution
Interface HistogramMBean

All Superinterfaces:

DistributionMBean

All Known Implementing Classes:

Histogram

public interface HistogramMBean
extends DistributionMBean

Abstract MBean interface for objects that describe the general characteristics of a distribution of (double) values recorded as a histogram. This interface supports the standard MBean management interface, so implementing classes will support JMX monitoring.

Method Summary

long[]	getBucketCounts() Gets the number of values recorded in each bucket.
double[]	getBucketMaximums() Gets the maximum bound for the histogram buckets.
double[]	getBucketMinimums() Gets the minimum bound for the histogram buckets.
double	getMedian() Gets the approximate median value, that is the value where half of the observed values are less than the median and half are greater.
int	getNumBuckets() Gets the total number of buckets.
double	getPercentile(int percent) Gets the (approximate) percentile value, that is the value where some desired percent of the observed values are less than the percentile value and the remainder are greater.
long	getPercentileRank(double value) Gets the (approximate) percentage of observed values that are less than a given value.

Methods inherited from interface com.netflix.stats.distribution.DistributionMBean

clear, getMaximum, getMean, getMinimum, getNumValues, getStdDev, getVariance

Method Detail

getNumBuckets

int getNumBuckets()

Gets the total number of buckets. Note that this includes any buckets added to handle out-of-range values.

getBucketCounts

long[] getBucketCounts()

Gets the number of values recorded in each bucket.

getBucketMinimums

double[] getBucketMinimums()

Gets the minimum bound for the histogram buckets. This is an inclusive minimum; values equal to the bucket limit are counted in this bucket.

getBucketMaximums

double[] getBucketMaximums()

Gets the maximum bound for the histogram buckets. This is an exclusive maximum; values equal to the bucket limit are counted in the subsequent bucket.

getMedian

double getMedian()

Gets the approximate median value, that is the value where half of the observed values are less than the median and half are greater.

getPercentile

double getPercentile(int percent)

Gets the (approximate) percentile value, that is the value where some desired percent of the observed values are less than the percentile value and the remainder are greater.

getPercentileRank

long getPercentileRank(double value)

Gets the (approximate) percentage of observed values that are less than a given value.