Yet another package to convert log messages to JSON.
Project description
Logging to JSON
Yet another log to JSON library for Python.
I needed a library that integrated well with applications that mixed logging using built-in logging outputs and JSON output.
I was also unable to find a library that worked with logging.QueueHandler
Thus this library was born.
Install
pip install log_to_json
or
conda install log_to_json -c conda-forge
Example
Basic Usage
from log_to_json import JsonFormatter
import logging
logger = logging.getLogger()
handler = logging.StreamHandler()
json_formatter = JsonFormatter(keys=("name",))
handler.setFormatter(json_formatter)
logger.critical({"app-name": "my-app", "app_version": "1.0"})
# produces the log
{"app-name": "my-app", "app_version": "1.0", "name": "root"}
Slightly more advanced Usage
from log_to_json import JsonFormatter
import logging
logger = logging.getLogger()
handler = logging.StreamHandler()
def finalizer(message_dict):
"""rename name to logger_name"""
message_dict["logger_name"] = message_dict.pop("name")
return message_dict
json_formatter = JsonFormatter(
keys=("message", "name", "user"),
formatters={"user": str.upper},
finalizer=finalizer
)
handler.setFormatter(json_formatter)
logger.critical("critical failure", extra={"user": "guest"})
# produces the message
{"message": "critical failure", "user": "GUEST", "logger_name": "root"}
Notable Features
Individual Key Formatters
Finalizer
Per Message Prefix
Integrates with non-JSON Logging
Pluggable Serializer
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
log_to_json-0.1.0.tar.gz
(5.3 kB
view hashes)
Built Distribution
Close
Hashes for log_to_json-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 032e02db446b35c585764955e4c644c01cdb894e5fe2d6b87a01eddb56a193ff |
|
MD5 | 1788317680f9be427cb37b939b17583f |
|
BLAKE2b-256 | 9965eaf3159efb072bde532bee546e80de88d02baf2783410c17d8c7de76303c |