Module observe 

Backend-neutral diagnostics: metric events and structured log events.

Re-exports

pub use crate::remote::MissReason;

Structs

Labels

Labels shared by layer-scoped events. Logical keys are never labels.

LogFacadeLogger

The default logger: the log crate facade.

OutcomeLabels

Labels of outcome-scoped events (shadow validation and recovery).

ShadowMismatchDetails

Bounded details of one confirmed shadow mismatch warning.

ShadowMismatchDiffDetails

The difference fields of a confirmed-mismatch warning, present when mismatch_logging.diff is above MismatchDiff::Off.

ShadowMismatchValueDetails

The whole-value fields of a confirmed-mismatch warning, present when mismatch_logging.value is on.

Enums

CoalescingScope

Where an in-flight execution was shared.

CompressionOperation

Which envelope direction a compression timing measures.

CompressionOutcome

Compression outcomes for writes and reads.

DisabledReason

Why a cache layer was skipped.

ErrorKind

Stable failure sites.

Event

One public diagnostic. Counters carry no value; timers report seconds; sizes report bytes.

Layer

The cache layer a diagnostic refers to.

LogEvent

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

LogLevel

Severity of a LogEvent.

RecoveryOutcome

Terminal outcomes of stale-on-error recovery.

SerializationOperation

Which codec direction a serialization timing measures.

ShadowMismatchLoggingOutcome

Outcomes of one confirmed-mismatch warning attempt. When more than one failure occurs, hook_error ranks above render_error, which ranks above logger_error.

ShadowOutcome

Terminal outcomes of sampled shadow validation.

Traits

Logger

Receives structured log events. Panics are isolated from cache results.

Observer

Receives every public diagnostic. Failures (returned errors or panics) never change a cache, source or maintenance result.