Python formatter for working with Logstash json filters.
Project description
Python logging formatter for creating log entries in a JSON logstash-friendly format.
Supports renaming of python default logging fields to logstash friendly names (e.g: renaming asctime to @timestamp)
LogstashFormatter can receive the following arguments:
fmt, list or tuple containing the fields to include in each entry. Defaults to [“asctime”, “levelname”, “filename”, “funcName”, “msg”, “exc_info”].
datefmt, date format string to be passed to formatTime(). Defaults to ISO8601 time format.
rename, dictionary containing mapping of { key: new_key } to be renamed. Defaults to { “asctime”: “@timestamp” }.
version, version as for the @version attribute used in Logstash. Defaults to “1”.
Sample output
{
"@timestamp": "2016-09-28T16:24:24,799",
"@version": "1",
"exc_info": null,
"filename": "<ipython-input-21-de248ad5b09c>",
"funcName": "<module>",
"levelname": "INFO",
"message": "This is a normal message to be logged"
}
Usage
Add LogstashFormatter as the formatter of your handler, as usual:
self.logger = logging.getLogger()
self.handler = logging.StreamHandler()
self.handler.setFormatter(LogstashFormatter())
self.logger.addHandler(self.handler)
Using in Django
Include logstash formatter in your settings file:
LOGGING = {
'formatters': {
'logstash': {
'()': 'logstash_formatter.LogstashFormatter',
'format': ("asctime", "levelname", "name", "lineno", "message",
"pathname", "module", "funcName", "process",),
'datefmt': '%Y-%m-%dT%H:%M:%S',
'rename': {
'asctime': '@timestamp',
},
'version': '1'
},
}
}
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
Built Distribution
Hashes for logstash-python-formatter-0.1.0b3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | c7559a1f44b14a05adc18a0025caf4de51f8eccc31befbd717703b56d965fc6b |
|
MD5 | c52ea41ae1621b8690b30efc81223757 |
|
BLAKE2b-256 | a0b929135760d375d6d687551ab40733198d68971ebc0d188be51aa9474bb029 |
Hashes for logstash_python_formatter-0.1.0b3-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ff9782c4770617facae0cd4ff5c28a4314cfad44f3f9d21e51946659280e302a |
|
MD5 | aee6df3ca8b671d07250ff299a59e366 |
|
BLAKE2b-256 | 0e94567a183dd836282da67881b59b39c4b1df0da2fc13b4a70e19f258b5ad3a |