Struct DynamicDistribution 

pub struct DynamicDistribution { /* private fields */ }

Distribution keyed by runtime label sets.

Each label set gets its own set of thread-local exponential histogram buckets.

Implementations

impl DynamicDistribution

pub fn new(shard_count: usize) -> Self

Creates a new runtime-labeled distribution with default cardinality cap.

pub fn with_max_series(shard_count: usize, max_series: usize) -> Self

Creates a new runtime-labeled distribution with a custom cardinality cap.

pub fn series(&self, labels: &[(&str, &str)]) -> DynamicDistributionSeries

Resolve a reusable series handle for labels.

Preferred for hot paths when labels come from a finite active set.

pub fn record(&self, labels: &[(&str, &str)], value: u64)

Record a value for the series identified by labels.

pub fn count(&self, labels: &[(&str, &str)]) -> u64

Get count for the series identified by labels.

pub fn sum(&self, labels: &[(&str, &str)]) -> u64

Get sum for the series identified by labels.

pub fn snapshot(&self) -> Vec<(DynamicLabelSet, u64, u64, ExpBucketsSnapshot)>

Returns a snapshot of all label-sets with their stats.

pub fn cardinality(&self) -> usize

Returns the current number of distinct label sets.

pub fn overflow_count(&self) -> u64

Returns the number of records routed to the overflow bucket.

A non-zero value indicates the cardinality cap was hit and label fidelity is being lost. Use this to alert on cardinality pressure.

pub fn evict_stale(&self, max_staleness: u32) -> usize

Evict series that haven’t been accessed for max_staleness cycles.

Call this after advance_cycle() in your sweeper task. Series are marked as evicted (so cached handles see the tombstone), then removed from the index.

Protected series (Arc::strong_count > 1) are never evicted — someone holds a DynamicDistributionSeries handle to them.

Returns the number of series evicted.

Trait Implementations

impl ClickHouseExport for DynamicDistribution

fn export_clickhouse( &self, batch: &mut ClickHouseMetricBatch, name: &str, description: &str, time_unix_nano: u64, )

impl DogStatsDExport for DynamicDistribution

fn export_dogstatsd( &self, output: &mut String, name: &str, tags: &[(&str, &str)], )

Export distribution as |d samples per label set for Datadog percentile computation.

impl OtlpExport for DynamicDistribution

fn export_otlp( &self, metrics: &mut Vec<Metric>, name: &str, description: &str, time_unix_nano: u64, )

Exports as native OTLP ExponentialHistogram (scale 0, base-2) per label set.

impl PrometheusExport for DynamicDistribution

fn export_prometheus(&self, output: &mut String, name: &str, help: &str)

Export distribution as summary (count + sum only, no quantiles).