Struct LogLevels 

pub struct LogLevels { /* private fields */ }

Runtime log level management for the loggers actuator endpoint.

Stores the current effective log level and per-logger overrides. Changes are ephemeral – they reset on restart.

Implementations

impl LogLevels

pub fn new(initial_level: &str) -> Self

Create a new LogLevels with the given initial level.

pub fn attach_reload_handle(&self, handle: FilterReloadHandle)

Attach the live-subscriber reload handle produced by telemetry init.

Called once by AppBuilder after the tracing subscriber is installed so subsequent Self::set_logger_level calls take effect on the running process (issue #1044).

pub fn reload_available(&self) -> bool

Returns true when a reload-capable subscriber is installed, i.e. level changes made via Self::set_logger_level actually reach the live tracing subscriber.

pub fn current_level(&self) -> String

Get the current global log level.

pub fn logger_overrides(&self) -> HashMap<String, String>

Get all per-logger overrides.

pub fn set_logger_level(&self, name: &str, level: &str) -> LogLevelChange

Set the level for a specific logger.

When a reload-capable subscriber is installed (see Self::attach_reload_handle), the rebuilt filter directive is pushed to the live tracing subscriber so the change takes effect immediately on the next event (issue #1044). Overrides remain ephemeral — they live only in this in-memory state and reset on process restart.

The returned LogLevelChange reflects the actual outcome, not merely handle presence:

• LogLevelChange::Applied — pushed to a live subscriber.
• LogLevelChange::Recorded — stored, but no reload-capable subscriber is installed (bare state / tests).
• LogLevelChange::Rejected — the map is at capacity, or the directive failed to apply and the override was rolled back so the map never claims a live override that isn’t (issue #1044).

The directive is applied while the write lock is held so that concurrent callers apply directives in the same order they mutate the map — the live subscriber can never disagree with GET /loggers (issue #1044 AC4). reload/apply never re-enters LogLevels, so this is deadlock-free.

Trait Implementations

impl Clone for LogLevels

fn clone(&self) -> LogLevels

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LogLevels

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

Formats the value using the given formatter.