> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/logging/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/nemo/relay/_mcp/server.

# Module logging

> Operational process logging for Relay (stderr + optional file sinks).

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`.

Operational process logging for Relay (stderr + optional file sinks).

Call sites emit through the `log` facade (`log::info!`, ...). This module owns the `spdlog-rs` backend, `LogCrateProxy` installation, formatters, and sink lifetime.

## Structs

* [FileLogRotationConfig](/reference/api/rust-library-reference/nemo-relay/logging/struct-filelogrotationconfig): Size-based rotation settings for a file log sink.
* [FileLogSinkConfig](/reference/api/rust-library-reference/nemo-relay/logging/struct-filelogsinkconfig): File sink settings for non-blocking operational logging.
* [LoggingConfig](/reference/api/rust-library-reference/nemo-relay/logging/struct-loggingconfig): Operational logging configuration for [`LoggingRuntime::configure`](/reference/api/rust-library-reference/nemo-relay/logging/struct-loggingruntime).
* [LoggingRuntime](/reference/api/rust-library-reference/nemo-relay/logging/struct-loggingruntime): Owns logging resources that must remain alive for the process / run lifetime.

## Enums

* [LogFormat](/reference/api/rust-library-reference/nemo-relay/logging/enum-logformat): Output encoding for an operational log sink.
* [LogLevel](/reference/api/rust-library-reference/nemo-relay/logging/enum-loglevel): Global / per-sink minimum severity for operational logs.
* [LogSinkConfig](/reference/api/rust-library-reference/nemo-relay/logging/enum-logsinkconfig): Additional operational log sink beyond always-on stderr.

## Constants

* [DEFAULT\_FILE\_FLUSH\_INTERVAL\_MILLIS](/reference/api/rust-library-reference/nemo-relay/logging/constant-default-file-flush-interval-millis): Default periodic flush interval when [`LoggingConfig::flush_interval_millis`](/reference/api/rust-library-reference/nemo-relay/logging/struct-loggingconfig) is omitted.
* [DEFAULT\_FILE\_SINK\_QUEUE\_ENTRIES](/reference/api/rust-library-reference/nemo-relay/logging/constant-default-file-sink-queue-entries): Default number of pending asynchronous queue entries per file sink when `queue_capacity` is omitted.
* [MAX\_FILE\_SINK\_QUEUE\_ENTRIES](/reference/api/rust-library-reference/nemo-relay/logging/constant-max-file-sink-queue-entries): Fixed hard maximum number of pending asynchronous queue entries per file sink.
* [MAX\_FILE\_SINK\_RETAINED\_FILES](/reference/api/rust-library-reference/nemo-relay/logging/constant-max-file-sink-retained-files): Fixed hard maximum number of retained backup files per rotating file sink.

## Functions

* [init\_logging](/reference/api/rust-library-reference/nemo-relay/logging/fn-init-logging): Installs process-wide operational logging from resolved config.

> Operational process logging for Relay (stderr + optional file sinks).

## Docs

- [Struct File LogRotation Config](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/logging/struct-filelogrotationconfig.md): Size-based rotation settings for a file log sink.
- [Struct File LogSink Config](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/logging/struct-filelogsinkconfig.md): File sink settings for non-blocking operational logging.
- [Struct Logging Config](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/logging/struct-loggingconfig.md): Operational logging configuration for `LoggingRuntime::configure`.
- [Struct Logging Runtime](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/logging/struct-loggingruntime.md): Owns logging resources that must remain alive for the process / run lifetime.
- [Enum LogFormat](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/logging/enum-logformat.md): Output encoding for an operational log sink.
- [Enum LogLevel](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/logging/enum-loglevel.md): Global / per-sink minimum severity for operational logs.
- [Enum LogSink Config](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/logging/enum-logsinkconfig.md): Additional operational log sink beyond always-on stderr.
- [Constant DEFAULT_FILE_FLUSH_INTERVAL_MILLIS](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/logging/constant-default-file-flush-interval-millis.md): Default periodic flush interval when `LoggingConfig::flush_interval_millis` is omitted.
- [Constant DEFAULT_FILE_SINK_QUEUE_ENTRIES](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/logging/constant-default-file-sink-queue-entries.md): Default number of pending asynchronous queue entries per file sink when `queue_capacity` is omitted.
- [Constant MAX_FILE_SINK_QUEUE_ENTRIES](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/logging/constant-max-file-sink-queue-entries.md): Fixed hard maximum number of pending asynchronous queue entries per file sink.
- [Constant MAX_FILE_SINK_RETAINED_FILES](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/logging/constant-max-file-sink-retained-files.md): Fixed hard maximum number of retained backup files per rotating file sink.
- [Function init_logging](https://docs.nvidia.com/nemo/relay/v0.9.4/reference/api/rust-library-reference/nemo-relay/logging/fn-init-logging.md): Installs process-wide operational logging from resolved config.