Skip to navigation

Struct Logging Runtime

View as Markdown

Generated from cargo doc --no-deps -p nemo-relay -p nemo-relay-adaptive -p nemo-relay-pii-redaction -p nemo-relay-ffi -p nemo-relay-types -p nemo-relay-plugin -p nemo-relay-worker-proto -p nemo-relay-worker.

pub struct LoggingRuntime { /* private fields */ }

Owns logging resources that must remain alive for the process / run lifetime.

When created by LoggingRuntime::configure, dropping this value flushes sinks and detaches this logger from the process-global spdlog log proxy if it is still installed.

Implementations

impl LoggingRuntime

impl LoggingRuntime

configure

pub fn configure(config: LoggingConfig) -> Result<Self>

Installs process-wide operational logging from resolved configuration.

Stderr is enabled by default and can be disabled with LoggingConfig::stderr_enabled. Explicit file sinks fail initialization if they cannot be opened. Dropping the returned runtime flushes sinks and detaches its logger from the process-global log proxy when it is still installed.

configure_with_diagnostics

pub fn configure_with_diagnostics(
    config: LoggingConfig,
    context: &Diagnostics,
) -> Result<Self>

Installs operational logging with diagnostics owned by an independent diagnostic context.

Sink initialization and delivery failures remain queryable when logging is unavailable or filtered. Configured sinks remain required, matching Self::configure. Diagnostic events are projected into this logger through a detachable subscription; sink failures update diagnostic state directly without being sent back through the failing logging pipeline. Exhausting diagnostic component or projection budgets does not prevent operational logging from starting; the diagnostic snapshot reports the available evidence and coverage loss. Dropping this runtime detaches the projection before draining sinks.

configure_from_file_path

pub fn configure_from_file_path(path: impl AsRef<Path>) -> Result<Self>

Loads logging configuration from an absolute TOML path and installs it process-wide.

configure_from_environment

pub fn configure_from_environment() -> Result<Self>

Resolves supported logging environment variables and installs the resulting configuration.

Built-in defaults are used when no logging environment variables are present.

root_relay_id

pub fn root_relay_id(&self) -> &str

Returns the process root Relay ID attached to operational records after initialization.

shutdown

pub fn shutdown(self)

Flushes buffered sinks and detaches global proxy wiring by dropping the runtime.

Trait Implementations

impl Drop for LoggingRuntime

impl Drop for LoggingRuntime

drop

fn drop(&mut self)