{ "info": { "author": "Volodymyr Klochan", "author_email": "vklochan@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 3", "Topic :: Internet :: WWW/HTTP", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: System :: Logging" ], "description": "python-logstash fork\n====================\n\nPython logging handler for Logstash.\n\nThis fork has some added features:\n - support for nested data structures\n - support for set as datatype\n - new http handler with support for ssl and basic auth\n - New config for limiting strings, containers and stacktraces\n - Version 0 Logging has been removed\n\nhttp://logstash.net/\n\nChangelog\n=========\n0.5.3\n - Remove Debug code\n0.5.2\n - New Config for Field / Stacktrace Limit\n - Removed Version 0 (old scheme)\n0.5.0\n - New HTTP Handler\n0.4.8\n - Add support for nested data and sets\n0.4.7\n - Add couple of sensitive fields to the skip_list\n0.4.6\n - Updated field names to match java counterparts supported by logstash crew\n0.4.5\n - Allow passing exchange's routing key to AMQP handler\n0.4.4\n - Fixed urllib import python3 compatibility.\n - Added long type to easy_types.\n0.4.3\n - Added AMQP handler.\n0.4.2\n - Updated README\n - Added ``tags`` parameter to handler\n0.4.1\n - Added TCP handler.\n0.3.1\n - Added support for Python 3\n0.2.2\n - Split Handler into Handler and Formatter classes\n0.2.1\n - Added support for the new JSON schema in Logstash 1.2.x. See details in\n http://tobrunet.ch/2013/09/logstash-1-2-0-upgrade-notes-included/ and\n https://logstash.jira.com/browse/LOGSTASH-675\n\n - Added ``version`` parameter. Available values: 1 (Logstash 1.2.x version format), 0 - default (previous version).\n\n\nInstallation\n============\n\nUsing pip::\n\n pip install python-logstash-nested\n\nUsage\n=====\n\n``LogstashHandler`` is a custom logging handler which sends Logstash messages using UDP.\n\nFor example::\n\n import logging\n import logstash\n import sys\n\n host = 'localhost'\n\n test_logger = logging.getLogger('python-logstash-logger')\n test_logger.setLevel(logging.INFO)\n test_logger.addHandler(logstash.LogstashHandler(host, 5959, version=1))\n # test_logger.addHandler(logstash.TCPLogstashHandler(host, 5959, version=1))\n\n test_logger.error('python-logstash: test logstash error message.')\n test_logger.info('python-logstash: test logstash info message.')\n test_logger.warning('python-logstash: test logstash warning message.')\n\n # add extra field to logstash message\n extra = {\n 'test_string': 'python version: ' + repr(sys.version_info),\n 'test_boolean': True,\n 'test_dict': {'a': 1, 'b': 'c'},\n 'test_float': 1.23,\n 'test_integer': 123,\n 'test_list': [1, 2, '3'],\n }\n test_logger.info('python-logstash: test extra fields', extra=extra)\n\nWhen using ``extra`` field make sure you don't use reserved names. From `Python documentation `_.\n | \"The keys in the dictionary passed in extra should not clash with the keys used by the logging system. (See the `Formatter `_ documentation for more information on which keys are used by the logging system.)\"\n\nTo use the AMQPLogstashHandler you will need to install pika first.\n\n pip install pika\n\nFor example::\n\n import logging\n import logstash\n\n test_logger = logging.getLogger('python-logstash-logger')\n test_logger.setLevel(logging.INFO)\n test_logger.addHandler(logstash.AMQPLogstashHandler(host='localhost', version=1))\n\n test_logger.info('python-logstash: test logstash info message.')\n try:\n 1/0\n except:\n test_logger.exception('python-logstash-logger: Exception with stack trace!')\n\n\n\nUsing with Django\n=================\n\nModify your ``settings.py`` to integrate ``python-logstash`` with Django's logging::\n\n LOGGING = {\n ...\n 'handlers': {\n 'logstash': {\n 'level': 'DEBUG',\n 'class': 'logstash.LogstashHandler',\n 'host': 'localhost',\n 'port': 5959, # Default value: 5959\n 'version': 1, # Version of logstash event schema. Default value: 0 (for backward compatibility of the library)\n 'message_type': 'logstash', # 'type' field in logstash message. Default value: 'logstash'.\n 'fqdn': False, # Fully qualified domain name. Default value: false.\n 'tags': ['tag1', 'tag2'], # list of tags. Default: None.\n },\n },\n 'loggers': {\n 'django.request': {\n 'handlers': ['logstash'],\n 'level': 'DEBUG',\n 'propagate': True,\n },\n },\n ...\n }\n\nExample Logstash Configuration\n==============================\n\nExample Logstash Configuration (``logstash.conf``) for Receiving Events from python-logstash is::\n\n input {\n udp {\n port => 5959\n codec => json\n }\n }\n output {\n stdout {\n codec => rubydebug\n }\n }\n\nFor TCP input you need to change the logstash's input to ``tcp`` and modify django log handler's class to ``logstash.TCPLogstashHandler``", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/offensity/python-logstash", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "python-logstash-nested", "package_url": "https://pypi.org/project/python-logstash-nested/", "platform": "", "project_url": "https://pypi.org/project/python-logstash-nested/", "project_urls": { "Homepage": "https://github.com/offensity/python-logstash" }, "release_url": "https://pypi.org/project/python-logstash-nested/0.5.3/", "requires_dist": null, "requires_python": "", "summary": "Python logging handler for Logstash.", "version": "0.5.3", "yanked": false, "yanked_reason": null }, "last_serial": 6022460, "releases": { "0.4.7": [ { "comment_text": "", "digests": { "md5": "139b91f3915b718579a00114b7a24aa0", "sha256": "d7de8497168fa5b81cdc8b4e4862c41eb675078f73be3257e21a8b82d0ab387b" }, "downloads": -1, "filename": "python-logstash-nested-0.4.7.tar.gz", "has_sig": false, "md5_digest": "139b91f3915b718579a00114b7a24aa0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6936, "upload_time": "2018-11-19T16:30:23", "upload_time_iso_8601": "2018-11-19T16:30:23.658636Z", "url": "https://files.pythonhosted.org/packages/8f/95/6352e95a5caa4a541b319deae77bb648d44aff8972ac35a0a1a2e54e8bbc/python-logstash-nested-0.4.7.tar.gz", "yanked": false, "yanked_reason": null } ], "0.5.1": [ { "comment_text": "", "digests": { "md5": "227cf94374d8bcd4643cd07166ceea2b", "sha256": "af32c6bf1b5b6487f60873cc986dbf2b6c78dcddfbedf373f6c45b3082efafc3" }, "downloads": -1, "filename": "python-logstash-nested-0.5.1.tar.gz", "has_sig": false, "md5_digest": "227cf94374d8bcd4643cd07166ceea2b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7768, "upload_time": "2019-07-24T14:49:17", "upload_time_iso_8601": "2019-07-24T14:49:17.356494Z", "url": "https://files.pythonhosted.org/packages/fe/ff/a09ddd87d092f861618d179978d1c38ffc2e99bb0305fd25d1aa78eeedb6/python-logstash-nested-0.5.1.tar.gz", "yanked": false, "yanked_reason": null } ], "0.5.2": [ { "comment_text": "", "digests": { "md5": "545405713da195db3d1aa0ded24a7d9e", "sha256": "10082a3dec285192ecb17041798937e6813b58dee40cea0cfea297615f5f3fa1" }, "downloads": -1, "filename": "python-logstash-nested-0.5.2.tar.gz", "has_sig": false, "md5_digest": "545405713da195db3d1aa0ded24a7d9e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8145, "upload_time": "2019-09-25T08:57:10", "upload_time_iso_8601": "2019-09-25T08:57:10.578609Z", "url": "https://files.pythonhosted.org/packages/f6/fa/c468d8dc2ddd45e2c1c28ced298f67e77ad8b646f746c57dad0d97e3c3ad/python-logstash-nested-0.5.2.tar.gz", "yanked": false, "yanked_reason": null } ], "0.5.3": [ { "comment_text": "", "digests": { "md5": "430aa60d8948e715f9ab9e42355cae17", "sha256": "4d00b80b253da520d323fbced927abc586b6fab478e8284ea26848e845a17132" }, "downloads": -1, "filename": "python-logstash-nested-0.5.3.tar.gz", "has_sig": false, "md5_digest": "430aa60d8948e715f9ab9e42355cae17", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8182, "upload_time": "2019-10-24T08:41:10", "upload_time_iso_8601": "2019-10-24T08:41:10.158250Z", "url": "https://files.pythonhosted.org/packages/c0/52/41a4b2414e1bf4c99413f53204189a1a8d24999214e90f63dd0e3433d06d/python-logstash-nested-0.5.3.tar.gz", "yanked": false, "yanked_reason": null } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "430aa60d8948e715f9ab9e42355cae17", "sha256": "4d00b80b253da520d323fbced927abc586b6fab478e8284ea26848e845a17132" }, "downloads": -1, "filename": "python-logstash-nested-0.5.3.tar.gz", "has_sig": false, "md5_digest": "430aa60d8948e715f9ab9e42355cae17", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8182, "upload_time": "2019-10-24T08:41:10", "upload_time_iso_8601": "2019-10-24T08:41:10.158250Z", "url": "https://files.pythonhosted.org/packages/c0/52/41a4b2414e1bf4c99413f53204189a1a8d24999214e90f63dd0e3433d06d/python-logstash-nested-0.5.3.tar.gz", "yanked": false, "yanked_reason": null } ], "vulnerabilities": [] }