Struct AccessTracker 

pub struct AccessTracker { /* private fields */ }

Tracks access frequency and recency for storage tiering and eviction.

Implementations

impl AccessTracker

pub fn new(config: TrackerConfig) -> Self

Create a new tracker with the provided configuration.

pub fn record_access(&mut self, cid: &str, size: u64, now: u64)

Record one access to cid at logical time now (seconds).

If this is the first access for cid a new AccessRecord is created. Otherwise the existing record is updated in-place and its score is recomputed. After recording, capacity is enforced.

pub fn compute_score(&self, record: &AccessRecord, now: u64) -> f64

Compute the temperature score for record at logical time now.

Formula:

score = access_count / (1 + time_since_last_access * decay_factor)

recency_weight from the config scales the final result so that operators can tune how much recency matters relative to raw frequency.

pub fn update_score(&mut self, cid: &str, now: u64)

Recompute and persist the score for the CID identified by cid.

This is useful when time has advanced without any new accesses.

pub fn is_hot(&self, cid: &str, now: u64) -> bool

Returns true when the CID’s current score exceeds hot_threshold.

pub fn is_cold(&self, cid: &str, now: u64) -> bool

Returns true when the CID’s current score is below cold_threshold.

pub fn hot_blocks(&self, now: u64) -> Vec<&AccessRecord>

All records currently scoring at or above hot_threshold.

pub fn cold_blocks(&self, now: u64) -> Vec<&AccessRecord>

All records currently scoring below cold_threshold.

pub fn evict_coldest(&mut self, now: u64) -> Option<AccessRecord>

Remove and return the single record with the lowest temperature score.

Returns None when the tracker is empty.

pub fn enforce_capacity(&mut self, now: u64) -> usize

Evict records until records.len() <= max_records.

Returns the number of records evicted in this call.

pub fn get_record(&self, cid: &str) -> Option<&AccessRecord>

Look up the record for cid, if present.

pub fn record_count(&self) -> usize

Number of records currently held.

pub fn stats(&self) -> &TrackerStats

Reference to the current aggregate statistics.

pub fn top_accessed(&self, n: usize) -> Vec<&AccessRecord>

The n most-accessed records, sorted by access_count descending.

If n exceeds the number of records, all records are returned.