Struct StorageAccessLog 

pub struct StorageAccessLog {
    pub entries: Vec<AccessLogEntry>,
    pub next_entry_id: u64,
    pub config: LogConfig,
    pub cumulative_ops: HashMap<LogOperation, u64>,
    pub cumulative_read_bytes: u64,
    pub cumulative_write_bytes: u64,
    pub seen_blocks: HashSet<u64>,
}

Append-only access log for storage operations.

Keeps a sliding window of at most config.max_entries entries; older entries are evicted FIFO. Cumulative statistics survive eviction.

Fields

entries: Vec<AccessLogEntry>

Sliding window of log entries.

next_entry_id: u64

Monotonically increasing counter used to assign AccessLogEntry::entry_id.

config: LogConfig

Active configuration.

cumulative_ops: HashMap<LogOperation, u64>

Cumulative per-operation counts (never decremented on eviction).

cumulative_read_bytes: u64

Total bytes read, cumulative.

cumulative_write_bytes: u64

Total bytes written, cumulative.

seen_blocks: HashSet<u64>

Set of every block ID ever logged.

Implementations

impl StorageAccessLog

pub fn new(config: LogConfig) -> Self

Create a new StorageAccessLog with the provided configuration.

pub fn log( &mut self, block_id: u64, cid: String, operation: LogOperation, size_bytes: u64, tick: u64, peer_id: Option<String>, )

Record a storage operation.

If the sliding window is full (entries.len() >= max_entries) the oldest entry is removed before the new one is appended.

pub fn detect_pattern(&self, current_tick: u64) -> AccessPattern

Detect the access pattern in the recent window.

Priority order:

1. BurstWrite — many writes in the last burst_window_ticks ticks.
2. Repeated — any block ID appears ≥ 3 times in the last 10 reads.
3. Sequential — the last 5 reads have strictly increasing block IDs.
4. Random — fallthrough.

pub fn entries_for_block(&self, block_id: u64) -> Vec<&AccessLogEntry>

Return all entries for a specific block ID, in log order.

pub fn entries_in_range( &self, from_tick: u64, to_tick: u64, ) -> Vec<&AccessLogEntry>

Return all entries whose tick falls in [from_tick, to_tick] (inclusive).

pub fn stats(&self) -> AccessLogStats

Snapshot of cumulative statistics.

pub fn clear(&mut self)

Clear the sliding window of entries.

Cumulative statistics (ops counts, bytes, seen_blocks) are not reset.