Struct LoggingTranslator 

pub struct LoggingTranslator { /* private fields */ }

Logging configuration translator for matching the Datadog Agent’s logging behavior.

In the Datadog Agent, all processes generally follow the same logging configuration, paying attention to the same settings for determining log level, log format, and so on. They differ in some ways, such as determining what file to write to when logging to file is enabled. Remote agents follow the same pattern.

LoggingTranslator takes LoggingSettings and generates a Saluki-oriented [LoggingConfiguration] from it, applying the remote agent’s own default log file and first-party log targets. This ensures that a remote agent obeys all the logging configuration rules set by the Datadog Agent but logs to the right location for its own process.

Implementations

impl LoggingTranslator

pub fn new(default_log_file: impl Into<PathBuf>) -> Self

Creates a new LoggingTranslator that logs to default_log_file unless a log file is configured explicitly.

A plain log level applies to FIRST_PARTY_LOG_TARGETS. Add the remote agent’s own crates with with_first_party_targets.

pub fn with_first_party_targets(self, targets: &[&'static str]) -> Self

Adds the given log targets to the ones that a plain log level applies to.

Like the entries in FIRST_PARTY_LOG_TARGETS, each target is a prefix, so my_remote_agent also covers a my_remote_agent_config crate.

pub fn translate( &self, settings: LoggingSettings, ) -> Result<LoggingConfiguration, GenericError>

Builds a [LoggingConfiguration] from the given settings, applying this remote agent’s rules.

Errors

Returns an error if the configured log level is not a level name or a valid set of filter directives.

pub fn translate_log_levels<S>( &self, levels: S, ) -> impl Stream<Item = LogLevel> + Send + 'static

where S: Stream<Item = String> + Send + 'static,

Translates each log level from levels into the form that [DynamicLogLevelWorker][saluki_app::logging::DynamicLogLevelWorker] applies.

Each level is parsed the same way as LoggingSettings::level in translate, so a plain level applies to the same first-party log targets as at startup. A level that can’t be parsed is logged and skipped, which leaves the current log level in place.

Trait Implementations

impl Clone for LoggingTranslator

fn clone(&self) -> LoggingTranslator

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LoggingTranslator

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.