Struct InferenceAuditLog 

pub struct InferenceAuditLog {
    pub entries: Mutex<Vec<AuditEntry>>,
    pub next_sequence: AtomicU64,
    pub max_entries: usize,
    pub stats: AuditStats,
}

Immutable, append-only audit trail for distributed inference queries.

Thread Safety

All public methods are &self and safe to call from multiple threads concurrently. Sequence assignment and entry insertion are performed under a single Mutex to guarantee ordering; stat counters use relaxed/acquire atomics for low-overhead reads.

Capacity

When entry_count() equals max_entries, append returns AuditError::CapacityExceeded. Call trim_before to free space.

Fields

entries: Mutex<Vec<AuditEntry>>

Ordered list of audit entries guarded by a mutex.

next_sequence: AtomicU64

Monotonically increasing sequence counter.

max_entries: usize

Maximum number of entries the log will hold before rejecting appends.

stats: AuditStats

Aggregate statistics.

Implementations

impl InferenceAuditLog

pub fn new(max_entries: usize) -> Self

Creates a new InferenceAuditLog with the given capacity.

pub fn append( &self, trace_id: &str, event: AuditEvent, ) -> Result<u64, AuditError>

Appends a new audit event to the log and returns its sequence number.

Errors

Returns AuditError::CapacityExceeded if the log is full.

pub fn entries_for_trace(&self, trace_id: &str) -> Vec<AuditEntry>

Returns all audit entries whose trace_id matches the given string.

Entries are returned in insertion (sequence) order.

pub fn events_since(&self, sequence: u64) -> Vec<AuditEntry>

Returns all entries with sequence > given.

Useful for tailing the log from a known checkpoint.

pub fn trim_before(&self, sequence: u64) -> usize

Removes all entries with sequence < given and returns how many were removed.

This operation is O(n) in the number of current entries. It updates the total_trimmed stat by the number of entries actually removed.

pub fn entry_count(&self) -> usize

Returns the current number of entries in the log.

pub fn trace_ids(&self) -> Vec<String>

Returns a sorted, deduplicated list of all trace IDs present in the log.

Trait Implementations

impl Default for InferenceAuditLog

fn default() -> Self

Returns the “default value” for a type.