Enum LogEvent 

pub enum LogEvent {
    KeyConstructionFailed(BoxError),
    PolicyResolutionFailed(BoxError),
    LocalReadFailed(BoxError),
    LocalWriteFailed(BoxError),
    RemoteReadFailed(BoxError),
    RemoteWriteFailed(BoxError),
    RecoveryPredicateFailed(BoxError),
    RecoveryDecodeFailed(BoxError),
    ShadowFillFailed(BoxError),
    ShadowMismatch(ShadowMismatchDetails),
    InvalidationFailed(BoxError),
}

Structured log events. All are fail-open diagnostics except the invalidation failure, which is also returned to the caller.

Variants

KeyConstructionFailed(BoxError)

The key selector failed or panicked, or the identity could not form a key; the source ran uncached. LogLevel::Error.

PolicyResolutionFailed(BoxError)

The policy provider failed or panicked, or the merged policy was malformed; the source ran uncached.

LocalReadFailed(BoxError)

The LocalStore read failed or panicked; the local layer was skipped for the call. LogLevel::Error.

LocalWriteFailed(BoxError)

The LocalStore write failed or panicked; the value was still returned.

RemoteReadFailed(BoxError)

The caller-serving remote read failed or exceeded its read budget. Detached shadow reads do not log.

RemoteWriteFailed(BoxError)

Preparing or dispatching a caller-serving remote write failed: encoding, compression, the write stamp or the adapter.

RecoveryPredicateFailed(BoxError)

The stale-recovery classifier panicked; recovery was denied.

RecoveryDecodeFailed(BoxError)

Decoding the retained stale frame failed during recovery; the source error was returned. Default formatting omits value-bearing error text; custom loggers can inspect the original error here.

ShadowFillFailed(BoxError)

A shadow job’s clean-miss fill failed while preparing or writing the payload.

ShadowMismatch(ShadowMismatchDetails)

A confirmed shadow mismatch, logged only when the resolved policy’s mismatch-logging value is on or its diff is above off.

InvalidationFailed(BoxError)

An explicit invalidation failed; the same error is returned to the caller.

Implementations

impl LogEvent

pub fn level(&self) -> LogLevel

LogLevel::Error for key construction and process-local read failures, LogLevel::Warn for everything else.

Trait Implementations

impl Debug for LogEvent

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

Formats the value using the given formatter.

impl Display for LogEvent

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

Formats the value using the given formatter.