Struct BlockCacheStats 

pub struct BlockCacheStats {
    pub hits: u64,
    pub misses: u64,
    pub decoded: u64,
    pub fetched: u64,
    pub entries: u64,
    pub resident_bytes: u64,
}

Point-in-time snapshot of BlockCache activity, for metrics/monitoring.

hits/misses/decoded/fetched are monotonic since the cache was created; entries/resident_bytes are the current (eventually-consistent) cache occupancy. Poll this periodically and export to your metrics backend (e.g. OpenTelemetry gauges/counters):

• hit ratio = hits / (hits + misses),
• decode-saving = 1 - decoded / misses,
• fetch amplification = fetched / decoded (1.0 = no duplicate fetches),
• resident_bytes vs the configured budget = memory pressure.

Fields

hits: u64

Probe hits (block already decoded and resident).

misses: u64

Probe misses (block needed fetch + decode).

decoded: u64

Blocks decoded (single-flighted; ~= unique cold blocks).

fetched: u64

Blocks fetched from the object store.

entries: u64

Current number of cached blocks (eventually consistent).

resident_bytes: u64

Current resident byte size of cached blocks (eventually consistent).

Trait Implementations

impl Clone for BlockCacheStats

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for BlockCacheStats

impl Debug for BlockCacheStats

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

Formats the value using the given formatter.

impl Eq for BlockCacheStats

impl PartialEq for BlockCacheStats

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for BlockCacheStats