Metadata-Version: 1.1
Name: python-logstash
Version: 0.2.0
Summary: Python logging handler for Logstash.
Home-page: https://github.com/vklochan/python-logstash
Author: Volodymyr Klochan
Author-email: vklochan@gmail.com
License: UNKNOWN
Description: python-logstash
        ===============
        
        Python logging handler for Logstash.
        
        Changelog
        =========
        0.2.0
          - 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: 0, 1. The default value is 0.
        
            - The version for the new JSON schema in The new JSON schema's version is 1.
        
        
        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,
                },
            },
            ...
          }
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Logging
