Struct StorageEventLog 

pub struct StorageEventLog { /* private fields */ }

A bounded, queryable log of StorageEvents.

When the number of stored events exceeds max_events, the oldest event is evicted on each new insertion.

Implementations

impl StorageEventLog

pub fn new(max_events: usize) -> Self

Create a new event log that retains at most max_events entries.

pub fn log( &mut self, event_type: EventType, severity: EventSeverity, message: &str, block_cid: Option<&str>, metadata: HashMap<String, String>, ) -> u64

Append a new event and return its unique id.

If the log has reached max_events, the oldest event is evicted first.

pub fn get_event(&self, id: u64) -> Option<&StorageEvent>

Look up an event by its id.

pub fn events_by_type(&self, event_type: EventType) -> Vec<&StorageEvent>

Return all events matching the given EventType.

pub fn events_by_severity(&self, severity: EventSeverity) -> Vec<&StorageEvent>

Return all events matching the given EventSeverity.

pub fn events_since(&self, tick: u64) -> Vec<&StorageEvent>

Return all events whose tick is strictly greater than tick.

pub fn count_by_type(&self, event_type: EventType) -> u64

Return the cumulative count of events of the given type (including evicted events).

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

Return the last n events (or fewer if the log is smaller).

pub fn tick(&mut self)

Advance the logical tick by one.

pub fn clear(&mut self)

Remove all events from the log.

Cumulative type counts and the current tick are preserved.

pub fn event_count(&self) -> usize

Return the number of events currently in the log.

pub fn stats(&self) -> EventLogStats

Compute aggregate statistics over the current event log.