Struct AtomicHistogram

pub struct AtomicHistogram { /* private fields */ }

A histogram that uses atomic 64bit counters for each bucket.

Unlike the non-atomic variant, it cannot be used directly to report percentiles. Instead, a snapshot must be taken which captures the state of the histogram at a point in time.

Implementations

impl AtomicHistogram

pub fn new(p: u8, n: u8) -> Result<Self, Error>

Construct a new atomic histogram from the provided parameters. See the documentation for crate::Config to understand their meaning.

pub fn with_config(config: &Config) -> Self

Creates a new atomic histogram using a provided crate::Config.

pub fn increment(&self, value: u64) -> Result<(), Error>

Increment the bucket that contains the value by one.

pub fn add(&self, value: u64, count: u64) -> Result<(), Error>

Increment the bucket that contains the value by some count.

pub fn drain(&self) -> Histogram

Drains the bucket values into a new Histogram

Unlike load, this method will reset all bucket values to zero. This uses AtomicU64::swap and is not available on platforms where AtomicU64::swap is not available.

pub fn load(&self) -> Histogram

Read the bucket values into a new Histogram