Skip to main content

A package that allows logs to be routed to different handlers based on a discriminant

Project description

python-log-router

A package that allows logs to be routed to different log handlers based on a discriminant. Each unique value of the discriminant is managed by a distinct handler.

Installation

pip install logrouter

Usage

Call logrouter.setup_logging() to setup the logging configuration by providing the configuration yaml absolute file path. You can also set the configuration path using an environment variable. Specify the name of the env variable by setting the env_path parameter.

For an example of a configuration file, refer to the default configuration file. You can specify the log handler to be used by replacing handlers.single_handler_class with the name of the handler. The default one is logrouter.logrouter.DefaultHandler, which inherits from logging.FileHandler.

The default logging configuration will route all the logs based on the discriminator field of the LogRecord object. To use the default configuration, call logrouter.setup_logging(use_default_config=True).

Examples

Run and look at the code and logs produced of the examples located at /examples to experience what you can achieve with logrouter.

Using different types of handlers

A new instance of single_handler_class handler class is used for each discriminator unique value. This instance receives the log level and the discriminator value when created. If you want to use a differnet handler class for some discriminant values, specify them in handlers.handlers_dict in the logging configuration file. See this example.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

logrouter-0.0.2.tar.gz (11.3 kB view hashes)

Uploaded Source

Built Distribution

logrouter-0.0.2-py3-none-any.whl (8.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page