Module logging 

The logging framework for Nautilus systems.

This module implements a high-performance logging subsystem that operates in a separate thread using an MPSC channel for log message delivery. The system uses reference counting to track active LogGuard instances, ensuring pending file logs are synced when the last guard drops.

LogGuard reference counting

The logging system maintains a global count of active LogGuard instances using an atomic counter (LOGGING_GUARDS_ACTIVE). When a LogGuard is created, the counter is incremented, and when dropped, it’s decremented. When the last LogGuard is dropped (counter reaches zero), pending file logs are synchronously flushed and synced. The process-global logging thread stays alive for later guard acquisitions and is only terminated by logging_shutdown.

The system supports a maximum of 255 concurrent LogGuard instances. Attempting to create more will cause a panic.

Re-exports

pub use macros::log_debug;

pub use macros::log_error;

pub use macros::log_info;

pub use macros::log_trace;

pub use macros::log_warn;

Modules

bridge

Tracing subscriber for capturing logs from external Rust libraries.

config

Logging configuration types and parsing.

headers

Standard startup, system, and version headers for log output.

logger

Core logger lifecycle, filtering, event formatting, and dispatch.

macros

Colored logging macros for enhanced log output with automatic color mapping.

writer

Stdout, stderr, and rotating file log writers.

Constants

CMD

DOC

EVT

RECV

REQ

RES

RPT

SEND

Functions

arm_shutdown_on_error

Arms shutdown-on-error handling for the current run.

disarm_shutdown_on_error

Disarms shutdown-on-error handling.

ensure_logging_initialized

Ensures logging is initialized on first use.

init_logging

Initialize logging.

log_task_aborted

Logs that a task was aborted.

log_task_awaiting

Logs that a task is being awaited.

log_task_error

Logs that there was an error in a task.

log_task_started

Logs that a task has started.

log_task_stopped

Logs that a task has stopped.

logging_clock_set_realtime_mode

Sets the global logging clock to real-time mode.

logging_clock_set_static_mode

Sets the global logging clock to static mode.

logging_clock_set_static_time

Sets the global logging clock static time with the given UNIX timestamp (nanoseconds).

logging_is_colored

Returns whether the core logger is using ANSI colors.

logging_is_initialized

Returns whether the core logger is enabled.

logging_set_bypass

Sets the logging subsystem to bypass mode.

logging_shutdown

Shuts down the logging subsystem.

logging_sync_to_disk

Flushes and syncs file logs to disk.

map_log_level_to_filter

Maps a LogLevel to a LevelFilter.

parse_component_levels

Parses component-specific log levels from a JSON value map.

parse_level_filter_str

Parses a string into a LevelFilter.

take_shutdown_on_error_trigger

Returns and clears the pending shutdown-on-error trigger, if one was recorded.

try_drain_shutdown_on_error_trigger

Conditionally drains the pending shutdown-on-error trigger.