Struct BlobCacheStats 

pub struct BlobCacheStats { /* private fields */ }

Implementations

impl BlobCacheStats

pub fn hits(&self) -> u64

Number of get/exists calls that resolved to Present / MaybePresent. Both count as hit prospects.

pub fn misses(&self) -> u64

Number of get/exists calls that resolved to Absent.

pub fn insertions(&self) -> u64

pub fn evictions(&self) -> u64

pub fn expirations(&self) -> u64

pub fn invalidations(&self) -> u64

pub fn namespace_flushes(&self) -> u64

pub fn version_mismatches(&self) -> u64

pub fn entries(&self) -> usize

pub fn bytes_in_use(&self) -> u64

Bytes resident in L1. Returned as u64 for symmetry with l2_bytes_in_use; upcast is lossless.

pub fn l1_bytes_max(&self) -> usize

pub fn l2_bytes_in_use(&self) -> u64

pub fn l2_bytes_max(&self) -> u64

pub fn l2_full_rejections(&self) -> u64

pub fn l2_metadata_reads(&self) -> u64

pub fn l2_negative_skips(&self) -> u64

pub fn synopsis_metadata_reads(&self) -> u64

Times the Bloom synopsis answered MaybePresent but the authoritative L2 metadata B+ tree said Absent. This is the cost of the probabilistic synopsis: a counter for the false-positive rate in production. Negative answers from the filter never trigger a metadata read (see l2_negative_skips).

pub fn synopsis_bytes(&self) -> u64

Total bytes used by all per-namespace Bloom synopsis filters.

pub fn namespaces(&self) -> usize

pub fn max_namespaces(&self) -> usize

pub fn promotion_queued(&self) -> u64

Total promotion requests successfully enqueued by get since boot. 0 when async promotion is disabled.

pub fn promotion_dropped(&self) -> u64

Total promotion requests dropped on queue saturation since boot. 0 when async promotion is disabled.

pub fn promotion_completed(&self) -> u64

Total promotion requests executed by workers since boot. 0 when async promotion is disabled.

pub fn promotion_queue_depth(&self) -> usize

Snapshot of pending requests in the promotion queue. 0 when async promotion is disabled.

pub fn l2_compression_ratio_observed(&self) -> f64

Running average of original_len / stored_len for L2 entries that the compressor actually shrank (#192). Returns 1.0 when no compressed entry has been observed yet, regardless of how many Raw entries have passed through (callers should pair this with l2_compression_skipped_total to interpret).

pub fn l2_compression_skipped_total(&self) -> u64

Number of L2 entries the compressor returned as Raw since boot — any reason: payload below min_bytes, content type already compressed, ratio gate fired, or cache.blob.l2_compression = "off".

pub fn l2_bytes_saved_total(&self) -> u64

Cumulative (original_len - stored_len) across all L2 entries the compressor shrank. Operators read this to size the L2 budget multiplier from real workloads.

pub fn l1_stale_serves_total(&self) -> u64

Counter — L1 hits served as stale by the SWR window of an ExtendedTtlPolicy (#194). 0 when no entry was written with an active extended policy.

pub fn l1_idle_evicts_total(&self) -> u64

Counter — L1 entries evicted by the idle-TTL gate of an ExtendedTtlPolicy (#194). 0 when no entry was written with an active extended policy.

Trait Implementations

impl Clone for BlobCacheStats

fn clone(&self) -> BlobCacheStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for BlobCacheStats

impl Debug for BlobCacheStats

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

Formats the value using the given formatter.

impl Default for BlobCacheStats

fn default() -> BlobCacheStats

Returns the “default value” for a type.

impl Eq for BlobCacheStats

impl PartialEq for BlobCacheStats

fn eq(&self, other: &BlobCacheStats) -> 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 BlobCacheStats