loghandler 0.2.0

Python logging library with support for multiple destinations

loghandler

loghandler allows you to easily log messages to multiple endpoints.

Using

Install loghandler via pip

pip install loghandler

In your code import LogHandler and initalize it.

from loghandler import LogHandler

logger = LogHandler({
    "log_level": "DEBUG",
    "outputs": [
        {
            "type": "STDOUT"
        }
    ]
})

You can now log messages to all your outputs via:

logger.log('fatal', Exception("Something went HORRIBLY wrong"))

Supported endpoints

• STDOUT
• elasticsearch

Coming soon

• database (MySQL, PostgreSQL, SQLite, ...)
• logstash
• sentry

And probably more.

Endpoints

General Configuration

All endpoints accept a few global settings. They are shown below.

log_level: For the output it's applied to, this will overrule the global configuration level

STDOUT

To use STDOUT as a log endpoint, add the following to your outputs array.

{
    "type": "STDOUT"
}

Elasticsearch

To use elasticsearch as a log endpoint, add the following to your outputs array.

{
    "type": "elasticsearch", 
    "config": {
        "hosts": ["https://your-es-host.com:9243"],
        "ssl": True,
        "verify_certs": True,
        "index": "your-index",  # Index will be created if it doesn't exist
        "api_key": ("your-api-key-id", "your-api-key-secret")
    }
}

Next time something is logged you should see something like the following under your index:

{
  "_index" : "logs",
  "_type" : "_doc",
  "_id" : "some-id",
  "_score" : 1.0,
  "_source" : {
    "timestamp" : "2021-11-05T04:16:25.250206",
    "level" : "DEBUG",
    "hostname" : "YOUR-HOSTNAME",
    "message" : "division by zero",
    "occurred_at" : {
      "path" : "/somepath/test.py",
      "line" : 22
    }
  }
}