histogram bucket
One counter inside a histogram that counts every observation at or below its upper boundary.
In more detail
Buckets are cumulative: a 30 millisecond request is counted in the 50 millisecond bucket and every larger one, and the +Inf bucket always equals the total count. The boundary is carried in the le label. A percentile is only as precise as the bucket it lands in, so put a boundary exactly at the number your objective names.
Example
With an objective of "under half a second", a 0.5 boundary makes the good-request ratio a single division.Related terms
- histogram — A metric that counts measurements, such as request durations, into ranges of values so their distribution and percentiles can be calculated.
- le label — The label on a histogram bucket that holds its upper boundary; le stands for "less than or equal to".
- histogram_quantile() — The PromQL function that estimates a percentile from a histogram's cumulative buckets.
- cardinality — The number of distinct values a metric label can take, which multiplies how many separate series a metric creates.
- percentile — The value below which a given percentage of measurements fall; p99 latency is the time 99 in 100 requests beat.
Taught in
- Metric Types: Summaries And Histograms — Full-Stack Observability: Metrics, Tracing & Logging
- Why A Histogram Beats An Average — Full-Stack Observability: Metrics, Tracing & Logging
- Cardinality And How It Bankrupts You — Full-Stack Observability: Metrics, Tracing & Logging
- The Prometheus Exposition Format — Full-Stack Observability: Metrics, Tracing & Logging
- Calculating Percentiles With histogram_quantile — Full-Stack Observability: Metrics, Tracing & Logging
- Ninety Nine Percent Of What? SLIs, SLOs And SLAs — Prometheus Certified Associate (PCA) Exam Prep
- Under A Second, On Average: Histograms — Prometheus Certified Associate (PCA) Exam Prep
- Thirty Second Checkouts Nobody Saw: Client Libraries — Prometheus Certified Associate (PCA) Exam Prep
- Milliseconds Versus Seconds: Naming Metrics And Labels — Prometheus Certified Associate (PCA) Exam Prep
- Twelve Green Panels: Dashboarding Basics — Prometheus Certified Associate (PCA) Exam Prep
- One Week, Three Objectives: Final Review — Prometheus Certified Associate (PCA) Exam Prep
- Partitioning, Sharding And Hot Keys — Scalable System Design & Distributed Architecture
- Observability As A Design Input — Scalable System Design & Distributed Architecture
- Worked Design Three: Scaling The Metrics Pipeline — Scalable System Design & Distributed Architecture