Struct StorageAccessLogger 

pub struct StorageAccessLogger {
    pub entries: VecDeque<AccessEntry>,
    pub max_entries: usize,
    pub stats: AccessStats,
    pub next_id: u64,
}

Bounded, structured audit log for storage operations.

Maintains a FIFO ring of AccessEntry records up to max_entries in length. When the ring is full, the oldest entry is evicted before the new one is appended. All mutations also update the running AccessStats.

Fields

entries: VecDeque<AccessEntry>

The ring of logged entries.

max_entries: usize

Maximum number of entries retained before oldest entries are dropped.

stats: AccessStats

Cumulative statistics over the lifetime of this logger (cleared with Self::clear).

next_id: u64

Monotonic counter for the next AccessEntry::entry_id.

Implementations

impl StorageAccessLogger

pub fn new(max_entries: usize) -> Self

Create a new logger with the given capacity.

max_entries sets the maximum number of entries held in memory. When this limit is reached the oldest entry is dropped on each new Self::log call. The default value used by higher-level helpers is 5000.

pub fn log( &mut self, cid: String, op: AccessOp, size_bytes: Option<u64>, latency_us: u64, success: bool, timestamp_secs: u64, caller_tag: String, )

Record a storage operation.

Parameters

• cid – Content identifier for the block involved.
• op – The operation type.
• size_bytes – Bytes written (meaningful for Put/BatchPut; pass None otherwise).
• latency_us – Operation latency in microseconds.
• success – Whether the operation completed without error.
• timestamp_secs– Unix timestamp (seconds).
• caller_tag – String label for the calling component.

pub fn recent(&self, n: usize) -> Vec<&AccessEntry>

Return references to the last n entries in chronological order.

If n exceeds the number of stored entries, all entries are returned.

pub fn entries_for_cid(&self, cid: &str) -> Vec<&AccessEntry>

Return all entries whose AccessEntry::cid matches cid.

pub fn entries_for_caller(&self, caller: &str) -> Vec<&AccessEntry>

Return all entries whose AccessEntry::caller_tag matches caller.

pub fn detect_pattern(&self) -> AccessPattern

Analyse the last 10 entries to detect an AccessPattern.

Detection priority:

1. Repeated — if any single CID appears 3 or more times.
2. Random — fallback (Sequential detection is deferred).

pub fn stats(&self) -> &AccessStats

Return a reference to the current AccessStats.

pub fn clear(&mut self)

Reset the logger to its initial empty state.

Clears all stored entries, resets statistics to zero, and restarts the entry-id counter from zero.