python-logstash
Python logging handler for Logstash. http://logstash.net/
Changelog
- 0.3.1
- Added support for Python 3
- 0.2.2
- Split Handler into Handler and Formatter classes
- 0.2.1
- Added support for the new JSON schema in Logstash 1.2.x. See details in
http://tobrunet.ch/2013/09/logstash-1-2-0-upgrade-notes-included/ and
https://logstash.jira.com/browse/LOGSTASH-675
- Added
version
parameter. Available values: 1 (Logstash 1.2.x version format), 0 - default (previous version).
- Added
- Added support for the new JSON schema in Logstash 1.2.x. See details in
http://tobrunet.ch/2013/09/logstash-1-2-0-upgrade-notes-included/ and
https://logstash.jira.com/browse/LOGSTASH-675
Installation
Using pip:
pip install python-logstash
Usage
LogstashHandler
is a custom logging handler which sends Logstash messages using UDP.
For example:
import logging import logstash test_logger = logging.getLogger('test_logger') test_logger.setLevel(logging.INFO) test_logger.addHandler(logstash.LogstashHandler('localhost', 5959, version=1)) test_logger.info('Test logstash message.')
Using with Django
Modify your settings.py
to integrate python-logstash
with Django's logging:
LOGGING = { ... 'handlers': { 'logstash': { 'level': 'DEBUG', 'class': 'logstash.LogstashHandler', 'host': 'localhost', 'port': 5959, 'version': 1, }, }, 'loggers': { 'django.request': { 'handlers': ['logstash'], 'level': 'DEBUG', 'propagate': True, }, }, ... }