Struct CacheStats 

pub struct CacheStats {
    pub hits: u64,
    pub misses: u64,
    pub entries: usize,
    pub peak_entries: usize,
    pub evictions: u64,
}

Snapshot of one EGLImage cache’s hit/miss counters.

The counters themselves have always existed (logged at Drop); this snapshot makes them assertable: steady-state tests capture stats after warmup and after an N-frame loop and require misses to stay flat — any increase means a convert re-imported a buffer it should have found cached, which is the cache-behavior equality gate for GL refactors.

Fields

hits: u64

misses: u64

entries: usize

peak_entries: usize

High-water mark of entries.

Since entries are retained past the lifetime of the tensor that produced them (the retention that CachedImport documents), each one pins its buffer, so occupancy — not hit rate — is what says how much memory a workload holds. Below capacity this is the workload’s true working-set size, and the number to size EDGEFIRST_EGL_CACHE_CAPACITY against.

It saturates at capacity, so on its own it cannot tell a workload that exactly fits from one that is thrashing — both report peak_entries == capacity. Read it together with evictions, which is what distinguishes them.

evictions: u64

Entries evicted to stay within capacity.

The signal that capacity is too small for the workload: every eviction discards an import that is likely to be asked for again, so a steady-state pipeline should reach zero. Nonzero-and-climbing with peak_entries == capacity is thrashing — raise EDGEFIRST_EGL_CACHE_CAPACITY, at the cost of pinning more buffers.

Trait Implementations

impl Clone for CacheStats

fn clone(&self) -> CacheStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CacheStats

impl Debug for CacheStats

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

Formats the value using the given formatter.

impl Eq for CacheStats

impl PartialEq for CacheStats

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CacheStats