Struct Service 

pub struct Service { /* private fields */ }

The background logging service.

Service owns the receive end of the MPSC channel, the currently active log file, and the unbound Unix Datagram Socket used for broadcasting. It runs entirely on a dedicated tokio task and never shares memory with the HTTP request threads.

Callers interact with the service indirectly through the [GLOBAL_LOGGER] sender and the [LoggerHandler] returned by Service::start. The Service itself is consumed by the background task and is not accessible after startup.

Implementations

impl Service

pub async fn start( capacity: usize, ) -> Result<(Sender<Entry>, LoggerHandler), Error>

Initializes the logging service and spawns its background task.

This method must be called once during server startup. It:

1. Creates a bounded MPSC channel with the specified capacity.
2. Resolves the XDG state directory and creates kosh/logs if it does not exist.
3. Opens (or creates) the current day’s log file in append mode.
4. Creates an unbound Unix Datagram Socket for broadcasting.
5. Spawns a dedicated tokio task that runs the Service::run loop.

The returned [Sender] should be stored in [GLOBAL_LOGGER] immediately after this call. The returned [LoggerHandler] should be kept alive and awaited during graceful shutdown via [LoggerHandler::shutdown_with_grace].

Errors

Returns [error::Error::LogDirectoryInitialization] if the XDG state directory cannot be determined. Returns [error::Error::Io] if the log directory cannot be created or the initial log file cannot be opened.

pub fn path() -> Option<PathBuf>