EPYLOG

Logs are the first.

This is a simple wrapper to standard logging library for Python.

Epylog provides to send log data to different sources e.g. file, rsyslog, graylog, http, etc.

Use different loggers for different needs and manage it from one place.

Installation

pip install epylog

Usage

• Move to project root directory and create logging.cfg file:

  cd /project/root
  touch logging.cfg
  

• Fill configuration file with you logging settings. Push to targets array everything you want to send to. And fill rules array with logger names (use * wildcard if you want) and set which targets loggers can use:

  {
    "targets": [
        {
          "name": "fl",
          "type":  "file",
          "filename": "/var/log/my_log.log"
        },
        {
          "name": "gl",
          "type":  "graylog",
          "host": "localhost",
          "port": 12202,
          "facility": "test"
        },
        {
          "name": "rsl",
          "type":  "syslog",
          "address": "localhost",
          "facility": "test"
        }
    ],
    "rules": [
        {  
          "name": "my_test_*",
          "min-level": "info",
          "write-to": "fl, gl",
          "format": "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
        },
        {  
          "name": "*",
           "min-level": "warning",
           "write-to": "rsl",
           "format": "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
        }
    ]
  }
  

• Finally call getLogger function to initialize your logger:

  from epylog import Logger
  
  # put some code here
  
  logger = Logger.getLogger('my_test_logger')
  logger.info('Hello from %s', logger.name)
  

• Enjoy sending your logs everywhere

Configuration reference

logging.cfg is a simple JSON object that descxribes all sources that you planning to use and associates loggers with this sources.

Targets

Tagrets are sources where can you send your logs.

...
    {
        "name": "fl",
        "type":  "file",
        ...
    }
...

Rules

Rules are patterns for associating user loggers with specific configuration.

...
    {  
      "name": "my_test_*",
      "min-level": "info",
      "write-to": "fl, gl",
      "format": "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
    }
...

License