Expand description
Structured logging infrastructure shared by operational observers.
Structs§
- Configured
Logger - Logger assembled from
LoggerConfig, including optional crash retention. - Console
Sink - Human-oriented stdout sink, with no terminal-color assumptions.
- File
Archive Config - Bounded archive configuration for rotated JSONL files.
- File
Sink - Synchronous bounded JSONL sink; callers choose it only outside hot paths.
- File
Sink Config - Bounded structured JSONL file configuration.
- LogDispatcher
- Thread-safe fan-out dispatcher; ordinary sinks receive only sanitized events.
- LogEvent
- Structured operational event passed through the sanitizer before normal sinks.
- LogField
- One structured field; paths must be supplied as fields instead of embedded text.
- LogPolicy
- Filters events before formatting and sanitizes values before ordinary sinks.
- LogStats
- Observable dispatcher counters; sink failures never recursively log.
- Logger
Config - Complete explicit logger configuration.
- Path
Aliases - Explicit local path aliases used by typed path fields.
- Ring
Buffer Sink - In-memory bounded diagnostic sink.
- Sensitive
DntSink - Encrypted DNT sink. It has no plaintext fallback and must be explicitly wired.
- Sensitive
DntSink Config - Explicit encrypted sensitive-output configuration.
- Verbosity
- Detail threshold from V1 (critical) through V9 (deep diagnostics).
Enums§
- LogConfig
Error - Invalid high-level logger configuration.
- LogOutput
Mode - Explicit destinations for ordinary operational logs.
- Sensitivity
- Explicit information-handling policy, never inferred from verbosity.
- Severity
- Operational impact of an event.
Constants§
- LOG_
SIZE_ 1_ MIB - One mebibyte, suitable for small local or short-lived logs.
- LOG_
SIZE_ 2_ MIB - Two mebibytes, suitable for small application crash logs.
- LOG_
SIZE_ 4_ MIB - Four mebibytes, suitable for modest local application logs.
- LOG_
SIZE_ 8_ MIB - Eight mebibytes, suitable for normal rotating application logs.
- LOG_
SIZE_ 16_ MIB - Sixteen mebibytes, suitable for moderate operational logs.
- LOG_
SIZE_ 32_ MIB - Thirty-two mebibytes, suitable for busier bounded services.
- LOG_
SIZE_ 64_ MIB - Sixty-four mebibytes, suitable for high-volume bounded services.
Traits§
- LogSink
- A destination receiving a sanitized event from
crate::LogDispatcher.