public static class LongTaskTimer.Builder
extends java.lang.Object
Modifier and Type | Method and Description |
---|---|
LongTaskTimer.Builder |
description(java.lang.String description) |
LongTaskTimer.Builder |
distributionStatisticBufferLength(java.lang.Integer bufferLength)
Statistics emanating from a timer 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).
|
LongTaskTimer.Builder |
distributionStatisticExpiry(java.time.Duration expiry)
Statistics emanating from a timer 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).
|
LongTaskTimer.Builder |
maximumExpectedValue(java.time.Duration max)
Sets the maximum value that this timer is expected to observe.
|
LongTaskTimer.Builder |
minimumExpectedValue(java.time.Duration min)
Sets the minimum value that this timer is expected to observe.
|
LongTaskTimer.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.
|
LongTaskTimer.Builder |
publishPercentileHistogram()
Adds histogram buckets used to generate aggregable percentile approximations in monitoring
systems that have query facilities to do so (e.g.
|
LongTaskTimer.Builder |
publishPercentileHistogram(java.lang.Boolean enabled)
Adds histogram buckets used to generate aggregable percentile approximations in monitoring
systems that have query facilities to do so (e.g.
|
LongTaskTimer.Builder |
publishPercentiles(double... percentiles)
Produces an additional time series for each requested percentile.
|
LongTaskTimer |
register(MeterRegistry registry)
Add the long task timer to a single registry, or return an existing long task timer in that registry.
|
LongTaskTimer.Builder |
serviceLevelObjectives(java.time.Duration... slos)
Publish at a minimum a histogram containing your defined service level objective (SLO) boundaries.
|
LongTaskTimer.Builder |
tag(java.lang.String key,
java.lang.String value) |
LongTaskTimer.Builder |
tags(java.lang.Iterable<Tag> tags) |
LongTaskTimer.Builder |
tags(java.lang.String... tags) |
public LongTaskTimer.Builder tags(java.lang.String... tags)
tags
- Must be an even number of arguments representing key/value pairs of tags.public LongTaskTimer.Builder tags(java.lang.Iterable<Tag> tags)
tags
- Tags to add to the eventual long task timer.public LongTaskTimer.Builder tag(java.lang.String key, java.lang.String value)
key
- The tag key.value
- The tag value.public LongTaskTimer.Builder description(@Nullable java.lang.String description)
description
- Description text of the eventual long task timer.public LongTaskTimer.Builder serviceLevelObjectives(@Nullable java.time.Duration... slos)
publishPercentileHistogram()
, the boundaries defined
here are included alongside other buckets used to generate aggregable percentile approximations.slos
- Publish SLO boundaries in the set of histogram buckets shipped to the monitoring system.public LongTaskTimer.Builder minimumExpectedValue(@Nullable java.time.Duration min)
min
- The minimum value that this timer is expected to observe.public LongTaskTimer.Builder maximumExpectedValue(@Nullable java.time.Duration max)
max
- The maximum value that this timer is expected to observe.public LongTaskTimer.Builder distributionStatisticExpiry(@Nullable java.time.Duration expiry)
distributionStatisticBufferLength(Integer)
.expiry
- The amount of time samples are accumulated to a histogram before it is reset and rotated.public LongTaskTimer.Builder distributionStatisticBufferLength(@Nullable java.lang.Integer bufferLength)
distributionStatisticExpiry(Duration)
, with this buffer length.bufferLength
- The number of histograms to keep in the ring buffer.public LongTaskTimer.Builder publishPercentiles(@Nullable double... percentiles)
publishPercentileHistogram()
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 LongTaskTimer.Builder percentilePrecision(@Nullable java.lang.Integer digitsOfPrecision)
digitsOfPrecision
- The digits of precision to maintain for percentile approximations.public LongTaskTimer.Builder publishPercentileHistogram()
histogram_quantile
,
Atlas' :percentiles
).public LongTaskTimer.Builder publishPercentileHistogram(@Nullable java.lang.Boolean enabled)
histogram_quantile
,
Atlas' :percentiles
).enabled
- Determines whether percentile histograms should be published.public LongTaskTimer register(MeterRegistry registry)
registry
- A registry to add the long task timer to, if it doesn't already exist.