Max Gauge¶
A Max Gauge is a value sampled at a point in time, but reported to the backend as the maximum value observed during the reporting interval rather than the last-write-wins behavior of a standard Gauge.
This is useful when you want to make sure spikes are visible rather than missed between samples. For example, when tracking a queue depth that fluctuates rapidly within a reporting interval, a Max Gauge ensures the peak is preserved.
Unlike a standard Gauge, Max Gauges do not continue to report after the last update and do not have a TTL. Once the reporting interval ends, the max is flushed and the next interval starts fresh.