Struct PoolStats 

pub struct PoolStats {
    pub hits: AtomicUsize,
    pub misses: AtomicUsize,
    pub checked_out: AtomicUsize,
    pub peak_checked_out: AtomicUsize,
    pub bytes_checked_out: AtomicUsize,
    pub peak_bytes_checked_out: AtomicUsize,
}

Pool statistics for observability.

All counters use relaxed atomics and are safe to read from any thread.

Example

use santh_bufpool::{BufferPool, PoolConfig};

let pool = BufferPool::new(PoolConfig::default());
let buf = pool.checkout(64).unwrap();
let stats = pool.stats().snapshot();
assert_eq!(stats.checked_out, 1);
drop(buf);

Fields

hits: AtomicUsize

Number of successful checkouts from the pool (reuse).

misses: AtomicUsize

Number of fallback allocations (pool exhausted).

checked_out: AtomicUsize

Number of buffers currently checked out.

peak_checked_out: AtomicUsize

Peak simultaneous checkouts observed.

bytes_checked_out: AtomicUsize

Total bytes currently checked out (sum of requested sizes).

peak_bytes_checked_out: AtomicUsize

Peak bytes checked out simultaneously.

Implementations

impl PoolStats

pub fn snapshot(&self) -> PoolStatsSnapshot

Snapshot the current stats.

Example

use santh_bufpool::{BufferPool, PoolConfig};

let pool = BufferPool::new(PoolConfig::default());
let snapshot = pool.stats().snapshot();
assert_eq!(snapshot.hits, 0);

Trait Implementations

impl Debug for PoolStats

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

Formats the value using the given formatter.

impl Default for PoolStats

fn default() -> PoolStats

Returns the “default value” for a type.