Struct CacheMetrics 

pub struct CacheMetrics {
    pub hits: u64,
    pub misses: u64,
    pub total_cached: u64,
    pub invalidations: u64,
    pub size: usize,
    pub memory_bytes: usize,
}

Cache metrics for monitoring.

Exposed via API for observability and debugging.

Fields

hits: u64

Number of cache hits (returned cached result).

misses: u64

Number of cache misses (executed query).

total_cached: u64

Total entries cached across all time.

invalidations: u64

Number of invalidations triggered.

size: usize

Current size of cache (number of entries).

memory_bytes: usize

Estimated memory usage in bytes.

This is a rough estimate based on cache key lengths and entry counts. Actual memory usage may vary based on result sizes.

Implementations

impl CacheMetrics

pub fn hit_rate(&self) -> f64

Calculate cache hit rate.

Returns ratio of hits to total requests (0.0 to 1.0).

Returns

• 1.0 if all requests were hits
• 0.0 if all requests were misses
• 0.0 if no requests yet

Example

use fraiseql_core::cache::CacheMetrics;

let metrics = CacheMetrics {
    hits: 80,
    misses: 20,
    total_cached: 100,
    invalidations: 5,
    size: 95,
    memory_bytes: 1_000_000,
};

assert_eq!(metrics.hit_rate(), 0.8);  // 80% hit rate

pub fn is_healthy(&self) -> bool

Check if cache is performing well.

Returns true if hit rate is above 60% (reasonable threshold).

Example

use fraiseql_core::cache::CacheMetrics;

let good_metrics = CacheMetrics {
    hits: 80,
    misses: 20,
    total_cached: 100,
    invalidations: 5,
    size: 95,
    memory_bytes: 1_000_000,
};

assert!(good_metrics.is_healthy());  // 80% > 60%

Trait Implementations

impl Clone for CacheMetrics

fn clone(&self) -> CacheMetrics

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CacheMetrics

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CacheMetrics

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CacheMetrics

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.