Package: python-logstash-nested
python-logstash forkPython logging handler for Logstash.This fork has some added features:support for nested data structuressupport for set as datatypenew http handler with support for ssl and basic authNew config for limiting strings, containers and stacktracesVersion 0 Logging has been removedhttp://logstash.net/Changelog0.5.3Remove Debug code0.5.2New Config for Field / Stacktrace LimitRemoved Version 0 (old scheme)0.5.0New HTTP Handler0.4.8Add support for nested data and sets0.4.7Add couple of sensitive fields to the skip_list0.4.6Updated field names to match java counterparts supported by logstash crew0.4.5Allow passing exchange’s routing key to AMQP handler0.4.4Fixed urllib import python3 compatibility.Added long type to easy_types.0.4.3Added AMQP handler.0.4.2Updated READMEAddedtagsparameter to handler0.4.1Added TCP handler.0.3.1Added support for Python 30.2.2Split Handler into Handler and Formatter classes0.2.1Added support for the new JSON schema in Logstash 1.2.x. See details inhttp://tobrunet.ch/2013/09/logstash-1-2-0-upgrade-notes-included/andhttps://logstash.jira.com/browse/LOGSTASH-675Addedversionparameter. Available values: 1 (Logstash 1.2.x version format), 0 - default (previous version).InstallationUsing pip:pip install python-logstash-nestedUsageLogstashHandleris a custom logging handler which sends Logstash messages using UDP.For example:import logging
import logstash
import sys

host = 'localhost'

test_logger = logging.getLogger('python-logstash-logger')
test_logger.setLevel(logging.INFO)
test_logger.addHandler(logstash.LogstashHandler(host, 5959, version=1))
# test_logger.addHandler(logstash.TCPLogstashHandler(host, 5959, version=1))

test_logger.error('python-logstash: test logstash error message.')
test_logger.info('python-logstash: test logstash info message.')
test_logger.warning('python-logstash: test logstash warning message.')

# add extra field to logstash message
extra = {
    'test_string': 'python version: ' + repr(sys.version_info),
    'test_boolean': True,
    'test_dict': {'a': 1, 'b': 'c'},
    'test_float': 1.23,
    'test_integer': 123,
    'test_list': [1, 2, '3'],
}
test_logger.info('python-logstash: test extra fields', extra=extra)When usingextrafield make sure you don’t use reserved names. FromPython documentation.“The keys in the dictionary passed in extra should not clash with the keys used by the logging system. (See theFormatterdocumentation for more information on which keys are used by the logging system.)”To use the AMQPLogstashHandler you will need to install pika first.pip install pikaFor example:import logging
import logstash

test_logger = logging.getLogger('python-logstash-logger')
test_logger.setLevel(logging.INFO)
test_logger.addHandler(logstash.AMQPLogstashHandler(host='localhost', version=1))

test_logger.info('python-logstash: test logstash info message.')
try:
    1/0
except:
    test_logger.exception('python-logstash-logger: Exception with stack trace!')Using with DjangoModify yoursettings.pyto integratepython-logstashwith Django’s logging:LOGGING = {
  ...
  'handlers': {
      'logstash': {
          'level': 'DEBUG',
          'class': 'logstash.LogstashHandler',
          'host': 'localhost',
          'port': 5959, # Default value: 5959
          'version': 1, # Version of logstash event schema. Default value: 0 (for backward compatibility of the library)
          'message_type': 'logstash',  # 'type' field in logstash message. Default value: 'logstash'.
          'fqdn': False, # Fully qualified domain name. Default value: false.
          'tags': ['tag1', 'tag2'], # list of tags. Default: None.
      },
  },
  'loggers': {
      'django.request': {
          'handlers': ['logstash'],
          'level': 'DEBUG',
          'propagate': True,
      },
  },
  ...
}Example Logstash ConfigurationExample Logstash Configuration (logstash.conf) for Receiving Events from python-logstash is:input {
  udp {
    port => 5959
    codec => json
  }
}
output {
  stdout {
    codec => rubydebug
  }
}For TCP input you need to change the logstash’s input totcpand modify django log handler’s class tologstash.TCPLogstashHandler