Struct AggregatedHistogram 

pub struct AggregatedHistogram { /* private fields */ }

An aggregated histogram with fixed buckets, suitable for Prometheus exposition.

Bucket layout follows a log-linear schedule. A metric name ending in _seconds selects the time-oriented bucket schedule; everything else uses the non-time schedule.

Implementations

impl AggregatedHistogram

pub fn new(metric_name: &str) -> Self

Creates a new AggregatedHistogram for the given metric name.

The metric name determines the bucket schedule: names ending in _seconds use a time-oriented schedule, everything else uses a generic non-time schedule.

pub fn merge(&mut self, other: &AggregatedHistogram)

Merges another aggregated histogram into this one.

The two histograms must have been constructed with the same bucket schedule (in practice, this means they were constructed for the same metric name).

pub fn merge_histogram(&mut self, histogram: &Histogram)

Folds the samples from histogram into this aggregated histogram.

pub fn sum(&self) -> f64

Returns the running sum of all observed samples.

pub fn count(&self) -> u64

Returns the running count of all observed samples.

pub fn buckets(&self) -> impl Iterator<Item = (&'static str, u64)> + '_

Returns an iterator over the buckets as (upper_bound_str, cumulative_count) pairs, in ascending order by upper bound.

Trait Implementations

impl Clone for AggregatedHistogram

fn clone(&self) -> AggregatedHistogram

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AggregatedHistogram

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.