Struct LoggingConfiguration 

pub struct LoggingConfiguration {
    pub log_level: LogLevel,
    pub log_format_json: bool,
    pub log_format_rfc3339: bool,
    pub log_to_console: bool,
    pub log_to_syslog: bool,
    pub syslog_uri: String,
    pub syslog_rfc: bool,
    pub log_file: String,
    pub log_file_max_size: ByteSize,
    pub log_file_max_rolls: usize,
}

Logging configuration.

This is a plain value type. Callers construct instances directly, either via simple for a basic console-only configuration or via a translator that maps from the application’s wider configuration into this type, applying any application-specific rules.

Fields

log_level: LogLevel

Verbosity directives (for example, info, debug, saluki=trace).

log_format_json: bool

Whether to emit log records as JSON instead of the default human-readable format.

log_format_rfc3339: bool

Whether to use RFC 3339 timestamps (2024-12-31T23:59:59Z) in log output.

When false (the default), timestamps use the legacy format (2024-12-31 23:59:59 UTC).

Defaults to false.

log_to_console: bool

Whether to write log records to standard output.

log_to_syslog: bool

Whether to write log records to syslog.

Defaults to false. When this is true and syslog_uri is empty, callers should resolve the destination to the platform’s default local syslog URI before constructing the logging output stack.

syslog_uri: String

URI of the syslog destination.

Defaults to an empty string. An empty value means “use the platform default” only when log_to_syslog is enabled; otherwise it has no effect. Supported URI schemes are handled by the syslog output implementation.

syslog_rfc: bool

Whether to use the Agent’s RFC-style syslog header.

Defaults to false, which preserves the Agent’s legacy syslog header format. Set this to true when the receiving syslog daemon expects the Agent’s RFC-style header.

log_file: String

Path to the log file to write to, or empty to disable file logging.

log_file_max_size: ByteSize

Maximum size of a log file before it’s rolled over.

log_file_max_rolls: usize

Maximum number of rolled-over log files to retain.

Implementations

impl LoggingConfiguration

pub fn simple() -> Self

Returns a configuration that writes only to the console in human-readable format at INFO level.

Used as a safe default when an application hasn’t yet supplied an explicit configuration.