socket-log-receiver 24.2.0a0

A light-weight socket log receiver

Socket Log Receiver

socket_log_receiver is a light-weight socket log receiving server. It aggregates messages from multi-process application via socket and logs to a single file. The service is intended to be used with Python's logging package, which does not support multi-process writes to a single file.

Installation

$ pip install socket-log-receiver

Basic Usage

The receiver service should be run as a service:

$ python -m socket_log_receiver  # as a module
$ log_receiver                   # as a command-line program

By default, the receiver service starts listening on localhost:9020.

In the application, use SocketHandler to send logs to the receiver service.

from logging.handlers import SocketHandler

handler = SocketHandler('localhost', 9020)  # handler to send logs to localhost:9020
logging.root.addHandler(handler)            # add the socket handler to the root logger

This way, the root logger sends logging messages to the receiver service.

Undefined Signal

The receiver service's configuration is managed by resconfig. By default, the dynamic configuration update is trigged by SIGHUP. Some systems might not make this signal available, in which case you could use a different signal for the trigger using the command-line option, e.g.

$ log_receiver --reload-signal SIGUSR2

Development

$ pip install -e .[dev]
$ pre-commit install

Running Tests

$ pip install -e .[test]
$ pytest