Struct MeasurementAggregate 

pub struct MeasurementAggregate { /* private fields */ }

Canonical shared arithmetic for local diagnostic summaries and distributions.

Re-exported so callers can name returned summaries without selecting a separate Metrics dependency. This is the shared type, with no local wrapper or arithmetic. Mergeable count, total and maximum in one consumer-selected unit.

Counts and totals clip independently at u64::MAX; sticky flags record actual overflow, so an exactly reached cap remains exact. Maximum is an individual observation and remains valid after overflow. There is no latest observation: unordered batches cannot establish ordering. No allocation or platform reads.

Implementations

impl MeasurementAggregate

pub const EMPTY: MeasurementAggregate

Empty aggregate, without a maximum observation.

pub const fn record(&mut self, value: u64)

Record one admitted observation, including zero, in the existing unit.

pub const fn merge(&mut self, other: MeasurementAggregate)

Combine observations from a batch without claiming ordering or identity.

Consumers must establish common units and deliberate sample attribution. This is addition, not deduplication: merging the same batch twice records it twice. Source overflow remains sticky even when its clipped value fits.

pub const fn samples(self) -> u64

Sample count, clipped at u64::MAX; check Self::samples_saturated.

pub const fn total(self) -> u64

Total, clipped at u64::MAX; check Self::total_saturated.

pub const fn samples_saturated(self) -> bool

Whether recording or merging has actually overflowed the sample count.

pub const fn total_saturated(self) -> bool

Whether recording or merging has actually overflowed the value total.

pub const fn maximum(self) -> Option<u64>

Largest observation, or None when empty, including after overflow.

pub const fn mean(self) -> Result<Option<u64>, MeasurementMeanError>

Floor-rounded mean, or None when empty. Exactly reached caps are valid.

Errors

Returns MeasurementMeanError::SaturatedSamples before MeasurementMeanError::SaturatedTotal when actual overflow is recorded.

pub const fn interval_since( self, previous: MeasurementAggregate, ) -> Result<MeasurementInterval, MeasurementIntervalError>

Exact count/total difference from an earlier snapshot of this accumulator.

Consumers must first establish matching units, window/reset identity and append-only continuity. This cannot detect a reset followed by numerically larger values or changed attribution. Maxima and latest values are not subtractable and are not returned. Empty intervals differ from added zeros.

Errors

Rejects sample overflow, total overflow, decreasing samples, decreasing totals, then a changed total with no added samples, in that order.

Trait Implementations

impl Clone for MeasurementAggregate

fn clone(&self) -> MeasurementAggregate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for MeasurementAggregate

impl Debug for MeasurementAggregate

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

Formats the value using the given formatter.

impl Default for MeasurementAggregate

fn default() -> MeasurementAggregate

Returns the “default value” for a type.

impl Eq for MeasurementAggregate

impl PartialEq for MeasurementAggregate

fn eq(&self, other: &MeasurementAggregate) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for MeasurementAggregate