Struct MaxGauge 

pub struct MaxGauge { /* private fields */ }

A thread-sharded maximum tracker exported as a gauge.

This is useful for recording peaks such as maximum queue depth or the highest number of in-flight requests seen during an export interval.

Unlike crate::Gauge, this is not a point-in-time set() value. Writers call observe, and readers aggregate by taking the maximum across shards.

Implementations

impl MaxGauge

pub fn new(shard_count: usize) -> Self

Create a new max gauge with all shards initialized to zero.

This is appropriate for metrics that are naturally non-negative.

pub fn with_value(shard_count: usize, initial: i64) -> Self

Create a new max gauge with all shards initialized to initial.

pub fn observe(&self, value: i64)

Record a candidate value for the maximum.

pub fn get(&self) -> i64

Return the current maximum across all shards.

pub fn reset(&self)

Reset all shards to the original value configured at construction.

This is intended for export/sampling code, not the hot path.

pub fn swap_reset(&self) -> i64

Reset all shards and return the previous maximum.

Concurrent observations that land on already-reset shards may be attributed to the next window rather than the current one. No maxima are lost, but timing near the reset boundary is eventually consistent in the same way as crate::Counter::swap.

Trait Implementations

impl ClickHouseExport for MaxGauge

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

impl Debug for MaxGauge

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

Formats the value using the given formatter.

impl Default for MaxGauge

fn default() -> Self

Returns the “default value” for a type.

impl DogStatsDExport for MaxGauge

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

Export this metric to the output string in DogStatsD format.

impl OtlpExport for MaxGauge

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

impl PrometheusExport for MaxGauge

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

Export this metric to the output string.