|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.HdrHistogram.EncodableHistogram org.HdrHistogram.DoubleHistogram org.HdrHistogram.SynchronizedDoubleHistogram
public class SynchronizedDoubleHistogram
SynchronizedDoubleHistogram
is a variant of DoubleHistogram
that is
synchronized as a whole, such that queries, copying, and addition operations are atomic with relation to
modification on the SynchronizedDoubleHistogram
, nd such that external accessors (e.g. iterations on the
histogram data) that synchronize on the SynchronizedDoubleHistogram
instance can safely assume that no
modifications to the histogram data occur within their synchronized block.
It is important to note that synchrionization can result in blocking recoding calls. If non-blocking recoding
operations are required, consider using ConcurrentDoubleHistogram
, or (recommended)
DoubleRecorder
which were intended for concurrent operations.
SynchronizedDoubleHistogram
supports the recording and analyzing sampled data value counts across a
configurable dynamic range of floating point (double) values, with configurable value precision within the range.
Dynamic range is expressed as a ratio between the hightes and lowest non-zero values trackable within the histogram
at any given time. Value precision is expressed as the number of significant [decimal] digits in the value recording,
and provides control over value quantization behavior across the value range and the subsequent value resolution at
any given level.
Auto-ranging: Unlike integer value based histograms, the specific value range tracked by a SynchronizedDoubleHistogram
is not specified upfront. Only the dynamic range of values that the histogram can
cover is (optionally) specified. E.g. When a ConcurrentDoubleHistogram
is created to track a dynamic range of
3600000000000 (enoygh to track values from a nanosecond to an hour), values could be recorded into into it in any
consistent unit of time as long as the ratio between the highest and lowest non-zero values stays within the
specified dynamic range, so recording in units of nanoseconds (1.0 thru 3600000000000.0), milliseconds (0.000001
thru 3600000.0) seconds (0.000000001 thru 3600.0), hours (1/3.6E12 thru 1.0) will all work just as well.
Auto-resizing: When constructed with no specified dynamic range (or when auto-resize is turned on with DoubleHistogram.setAutoResize(boolean)
) a SynchronizedDoubleHistogram
will auto-resize its dynamic
range to include recorded values as they are encountered. Note that recording calls that cause auto-resizing may
take longer to execute, as resizing incurrs allocation and copying of internal data structures.
Attempts to record non-zero values that range outside of the specified dynamic range (or exceed the limits of
of dynamic range when auto-resizing) may results in ArrayIndexOutOfBoundsException
exceptions, either
due to overflow or underflow conditions. These exceptions will only be thrown if recording the value would have
resulted in discarding or losing the required value precision of values already recorded in the histogram.
See package description for org.HdrHistogram
for details.
Nested Class Summary |
---|
Nested classes/interfaces inherited from class org.HdrHistogram.DoubleHistogram |
---|
DoubleHistogram.AllValues, DoubleHistogram.LinearBucketValues, DoubleHistogram.LogarithmicBucketValues, DoubleHistogram.Percentiles, DoubleHistogram.RecordedValues |
Constructor Summary | |
---|---|
SynchronizedDoubleHistogram(ConcurrentDoubleHistogram source)
Construct a SynchronizedDoubleHistogram with the same range settings as a given source,
duplicating the source's start/end timestamps (but NOT it's contents) |
|
SynchronizedDoubleHistogram(int numberOfSignificantValueDigits)
Construct a new auto-resizing DoubleHistogram using a precision stated as a number of significant decimal digits. |
|
SynchronizedDoubleHistogram(long highestToLowestValueRatio,
int numberOfSignificantValueDigits)
Construct a new DoubleHistogram with the specified dynamic range (provided in highestToLowestValueRatio ) and using a precision stated as a number of significant
decimal digits. |
Method Summary |
---|
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public SynchronizedDoubleHistogram(int numberOfSignificantValueDigits)
numberOfSignificantValueDigits
- Specifies the precision to use. This is the number of significant
decimal digits to which the histogram will maintain value resolution
and separation. Must be a non-negative integer between 0 and 5.public SynchronizedDoubleHistogram(long highestToLowestValueRatio, int numberOfSignificantValueDigits)
highestToLowestValueRatio
) and using a precision stated as a number of significant
decimal digits.
highestToLowestValueRatio
- specifies the dynamic range to usenumberOfSignificantValueDigits
- Specifies the precision to use. This is the number of significant
decimal digits to which the histogram will maintain value resolution
and separation. Must be a non-negative integer between 0 and 5.public SynchronizedDoubleHistogram(ConcurrentDoubleHistogram source)
SynchronizedDoubleHistogram
with the same range settings as a given source,
duplicating the source's start/end timestamps (but NOT it's contents)
source
- The source histogram to duplicate
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |