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 details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

Details for the file logrouter-0.0.2.tar.gz.

File metadata

  • Download URL: logrouter-0.0.2.tar.gz
  • Upload date:
  • Size: 11.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.16

File hashes

Hashes for logrouter-0.0.2.tar.gz
Algorithm Hash digest
SHA256 3a294821fb60bbf267d0058366ef0e6a11cfbc58c8fc03796ac72e4b87777ca7
MD5 d6dcb32a6be8c86b75e4bb28692c9e2b
BLAKE2b-256 44af269e706e6f1f023e5ce7ac3da6203d5bd5b266bc8913bad28a399efda48f

See more details on using hashes here.

File details

Details for the file logrouter-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: logrouter-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 8.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.16

File hashes

Hashes for logrouter-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 1a1c3fefa172d5ef154d52a3f47a0b257246e7d6698b34b761dcf7bd53baff79
MD5 5e61c4d94a6d354a8297f8e487ddcda3
BLAKE2b-256 e5be0fbf54b31a7d83de7e4ba601d93de84d8a2fae7adfca2dc1b0bffbce85af

See more details on using hashes here.

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