Struct AuditTrail 

pub struct AuditTrail { /* private fields */ }

Audit trail manager

Implementations

impl AuditTrail

pub fn new(config: AuditTrailConfig) -> Self

Create a new audit trail with the given configuration.

pub fn log_event( &mut self, event_type: AuditEventType, cid: &str, actor: &str, details: &str, bytes: u64, success: bool, ) -> u64

Record an event and return its sequence number.

If config.log_reads is false, BlockGet events are silently dropped and the returned sequence number is 0.

pub fn query(&self, filter: &AuditFilter) -> Vec<&AuditEntry>

Return entries matching every predicate in filter.

pub fn get_entry(&self, sequence: u64) -> Option<&AuditEntry>

Look up an entry by its sequence number.

pub fn verify_integrity(&self) -> Result<(), Vec<u64>>

Verify the integrity checksum of every entry.

Returns Ok(()) when all entries pass, or Err(bad_seqs) with the sequence numbers that failed.

pub fn prune_before(&mut self, timestamp: u64) -> usize

Remove all entries whose timestamp is strictly before timestamp.

Returns the number of entries removed.

pub fn prune_to_capacity(&mut self) -> usize

Trim the trail to config.max_entries, removing the oldest entries first. Returns the number of entries removed.

pub fn entry_count(&self) -> usize

Number of entries currently held.

pub fn last_entry(&self) -> Option<&AuditEntry>

The most recently appended entry, if any.

pub fn stats(&self) -> &AuditTrailStats

Current aggregate statistics.

pub fn events_for_cid(&self, cid: &str) -> Vec<&AuditEntry>

All events that reference a particular CID.

pub fn recent_failures(&self, count: usize) -> Vec<&AuditEntry>

The most recent count entries where success == false, newest first.