Struct AuditLog 

pub struct AuditLog { /* private fields */ }

Cloneable, cheap handle that broker code calls to record events.

Implementations

impl AuditLog

pub fn new(capacity: usize) -> (Arc<Self>, AuditReceiver)

Create a fail-open log.

pub fn new_with_mode( capacity: usize, mode: AuditMode, ) -> (Arc<Self>, AuditReceiver)

Create an enabled log with an explicit privileged-record policy.

pub fn new_with_mode_and_spool( capacity: usize, mode: AuditMode, spool: &Spool, ) -> (Arc<Self>, AuditReceiver)

Create an enabled log backed by the spool’s durable loss counter.

pub fn disabled() -> Arc<Self>

A no-op log for a disabled audit subsystem.

pub fn emit(&self, event: AuditEvent)

Record an ordinary fail-open event without blocking.

pub async fn emit_required(&self, event: AuditEvent) -> Result<(), AuditError>

Durably record a privileged write-ahead event in fail-closed mode.

Fail-open mode retains the non-blocking behavior of Self::emit. Fail-closed mode refuses immediately under queue backpressure, then waits until the writer confirms that the sink or spool accepted the record durably.

Errors

Returns an unavailable error if the queue is full, the writer stopped, or neither the sink nor spool can durably store the record.

pub fn mode(&self) -> AuditMode

Whether privileged actions require durable write-ahead audit records.

pub fn close(&self)

Close the event stream for every clone of this handle.

pub fn dropped(&self) -> u64

Count events lost or refused because audit processing was unavailable.

Trait Implementations

impl Debug for AuditLog

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.