Struct CacheDiagnostics 

pub struct CacheDiagnostics {
    pub stats: CacheStats,
    pub estimated_entries: u64,
}

User-facing diagnostic snapshot for a local cache instance.

CacheDiagnostics combines lightweight counters with runtime-level observations such as the approximate number of entries currently known to the local backend. The values are snapshots, not a durable metrics store.

Example

use hydracache_core::{CacheDiagnostics, CacheStats};

let diagnostics = CacheDiagnostics {
    stats: CacheStats {
        hits: 1,
        misses: 1,
        ..CacheStats::default()
    },
    estimated_entries: 1,
};

assert_eq!(diagnostics.total_requests(), 2);
assert_eq!(diagnostics.hit_ratio(), Some(0.5));
assert!(!diagnostics.is_empty());

Fields

stats: CacheStats

Lightweight cache counters.

estimated_entries: u64

Approximate number of entries currently held by the local backend.

This value comes from the in-memory backend and is meant for debugging and smoke checks, not billing, quotas, or exact accounting.

Implementations

impl CacheDiagnostics

pub fn total_requests(&self) -> u64

Return the number of lookup attempts represented by this snapshot.

pub fn hit_ratio(&self) -> Option<f64>

Return the hit ratio represented by this snapshot.

pub fn is_empty(&self) -> bool

Return whether the local backend currently appears empty.

Trait Implementations

impl Clone for CacheDiagnostics

fn clone(&self) -> CacheDiagnostics

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CacheDiagnostics

impl Debug for CacheDiagnostics

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

Formats the value using the given formatter.

impl Default for CacheDiagnostics

fn default() -> CacheDiagnostics

Returns the “default value” for a type.

impl PartialEq for CacheDiagnostics

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for CacheDiagnostics