public static class DistributionStatisticConfig.Builder
extends java.lang.Object
Constructor and Description |
---|
Builder() |
Modifier and Type | Method and Description |
---|---|
DistributionStatisticConfig.Builder |
bufferLength(java.lang.Integer bufferLength)
Statistics like max, percentiles, and histogram counts decay over time to give greater weight to recent
samples (exception: histogram counts are cumulative for those systems that expect cumulative
histogram buckets).
|
DistributionStatisticConfig |
build() |
DistributionStatisticConfig.Builder |
expiry(java.time.Duration expiry)
Statistics like max, percentiles, and histogram counts decay over time to give greater weight to recent
samples (exception: histogram counts are cumulative for those systems that expect cumulative
histogram buckets).
|
DistributionStatisticConfig.Builder |
maximumExpectedValue(java.lang.Double max)
The maximum value that the meter is expected to observe.
|
DistributionStatisticConfig.Builder |
maximumExpectedValue(java.lang.Long max)
Deprecated.
Use
maximumExpectedValue(Double) instead since 1.4.0. |
DistributionStatisticConfig.Builder |
minimumExpectedValue(java.lang.Double min)
The minimum value that the meter is expected to observe.
|
DistributionStatisticConfig.Builder |
minimumExpectedValue(java.lang.Long min)
Deprecated.
Use
minimumExpectedValue(Double) instead since 1.4.0. |
DistributionStatisticConfig.Builder |
percentilePrecision(java.lang.Integer digitsOfPrecision)
Determines the number of digits of precision to maintain on the dynamic range histogram used to compute
percentile approximations.
|
DistributionStatisticConfig.Builder |
percentiles(double... percentiles)
Produces an additional time series for each requested percentile.
|
DistributionStatisticConfig.Builder |
percentilesHistogram(java.lang.Boolean enabled) |
DistributionStatisticConfig.Builder |
serviceLevelObjectives(double... slos)
Publish at a minimum a histogram containing your defined Service Level Objective (SLO) boundaries.
|
DistributionStatisticConfig.Builder |
sla(double... sla)
Deprecated.
Use
serviceLevelObjectives(double...) instead. "Service Level Agreement" is
more formally the agreement between an engineering organization and the business. Service Level Objectives
are set more conservatively than the SLA to provide some wiggle room while still satisfying the business
requirement. SLOs are the threshold we intend to measure against, then. |
DistributionStatisticConfig.Builder |
sla(long... sla)
Deprecated.
Use
serviceLevelObjectives(double...) instead. "Service Level Agreement" is
more formally the agreement between an engineering organization and the business. Service Level Objectives
are set more conservatively than the SLA to provide some wiggle room while still satisfying the business
requirement. SLOs are the threshold we intend to measure against, then. |
public DistributionStatisticConfig.Builder percentilesHistogram(@Nullable java.lang.Boolean enabled)
public DistributionStatisticConfig.Builder percentiles(@Nullable double... percentiles)
DistributionStatisticConfig.percentileHistogram
to publish a histogram that can be used to generate aggregable percentile approximations.percentiles
- Percentiles to compute and publish. The 95th percentile should be expressed as 0.95
.public DistributionStatisticConfig.Builder percentilePrecision(@Nullable java.lang.Integer digitsOfPrecision)
digitsOfPrecision
- The digits of precision to maintain for percentile approximations.public DistributionStatisticConfig.Builder serviceLevelObjectives(@Nullable double... slos)
DistributionStatisticConfig.percentileHistogram
, the boundaries defined here are included alongside other buckets used to
generate aggregable percentile approximations. If the DistributionStatisticConfig
is meant for
use with a Timer
, the SLO unit is in nanoseconds.slos
- The SLO boundaries to include the set of histogram buckets shipped to the monitoring system.@Deprecated public DistributionStatisticConfig.Builder sla(@Nullable double... sla)
serviceLevelObjectives(double...)
instead. "Service Level Agreement" is
more formally the agreement between an engineering organization and the business. Service Level Objectives
are set more conservatively than the SLA to provide some wiggle room while still satisfying the business
requirement. SLOs are the threshold we intend to measure against, then.DistributionStatisticConfig.percentileHistogram
, the boundaries defined here are included alongside other buckets used to
generate aggregable percentile approximations. If the DistributionStatisticConfig
is meant for
use with a Timer
, the SLA unit is in nanoseconds.sla
- The SLA boundaries to include the set of histogram buckets shipped to the monitoring system.@Deprecated public DistributionStatisticConfig.Builder sla(@Nullable long... sla)
serviceLevelObjectives(double...)
instead. "Service Level Agreement" is
more formally the agreement between an engineering organization and the business. Service Level Objectives
are set more conservatively than the SLA to provide some wiggle room while still satisfying the business
requirement. SLOs are the threshold we intend to measure against, then.DistributionStatisticConfig.percentileHistogram
, the boundaries defined here are included alongside other buckets used to
generate aggregable percentile approximations. If the DistributionStatisticConfig
is meant for
use with a Timer
, the SLA unit is in nanoseconds.sla
- The SLA boundaries to include the set of histogram buckets shipped to the monitoring system.@Deprecated public DistributionStatisticConfig.Builder minimumExpectedValue(@Nullable java.lang.Long min)
minimumExpectedValue(Double)
instead since 1.4.0.min
- The minimum value that this distribution summary is expected to observe.public DistributionStatisticConfig.Builder minimumExpectedValue(@Nullable java.lang.Double min)
min
- The minimum value that this distribution summary is expected to observe.@Deprecated public DistributionStatisticConfig.Builder maximumExpectedValue(@Nullable java.lang.Long max)
maximumExpectedValue(Double)
instead since 1.4.0.max
- The maximum value that the meter is expected to observe.public DistributionStatisticConfig.Builder maximumExpectedValue(@Nullable java.lang.Double max)
max
- The maximum value that the meter is expected to observe.public DistributionStatisticConfig.Builder expiry(@Nullable java.time.Duration expiry)
bufferLength(java.lang.Integer)
.expiry
- The amount of time samples are accumulated to decaying distribution statistics before they are
reset and rotated.public DistributionStatisticConfig.Builder bufferLength(@Nullable java.lang.Integer bufferLength)
expiry(java.time.Duration)
, with this buffer length.bufferLength
- The number of histograms to keep in the ring buffer.public DistributionStatisticConfig build()