A histogram with a configurable number of buckets.

To create a Histogram with labels and three buckets, and register it with the default Registry:

Histogram sampleHistogram("sample_histogram"s, {
    .help = "A sample histogram"s,
    .labelNames = {"label1"s, "label2"s},
    .buckets = {0.5, 1.0, 5.0}
});

To observe a value with a Histogram (with labels):

sampleHistogram.labels({"value1"s, "value2"}).observe(1.5);

To create a Histogram without labels and register it with the default Registry:

Histogram simpleHistogram("simple_histogram"s, {
    .help = "A simple histogram"s,
    .buckets = {0.5, 1.0, 5.0}
});

To observe a value with a Histogram (without labels):

simpleHistogram.observe(1.5);

Creates a Histogram with the given name and registers it with the default registry.

Creates a Histogram with the given name and params, and registers it with the default registry.

Creates a Histogram with the given name and registers it with the given registry (if not nullptr).

Creates a Histogram with the given name and params, and registers it with the given registry (if not nullptr).

Destroys the Histogram.

Sets the Histogram's bucket upper bounds.

Upper bounds must be strictly ordered from lowest to highest value. The final infinite bucket must not be included.

Must only be set once, immediately after creating the Histogram.

Returns the configured bucket upper bounds.

Returns the histogram's data.

Sets the Histogram's help text.

Must only be set once, immediately after creating the Histogram.

Sets the Histogram's label names.

Must only be set once, immediately after creating the Gauge. The label name "le" must not be used as it is reserved for the histogram.

Observes the given amount, by increasing the count in the respective bucket.

Converts the given Clock time in microseconds to seconds and increases the count in the respective bucket.

Can only be used if no labels have been defined.