{ "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\n===============\n\nPython logging handler for Logstash.\nhttp://logstash.net/\n\nChangelog\n=========\n0.6.1\n - Repair `FileLogstashHandler`'s `version` parameter useless problem.\n0.6.0\n - Add parameters to the class that can customize the formatter.\n0.5.0\n - Add File handler.\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\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 'logstash-file': {\n 'level': 'DEBUG',\n 'class': 'logstash.FileLogstashHandler',\n 'filename': 'logstash.log',\n }\n },\n 'loggers': {\n 'django.request': {\n 'handlers': ['logstash', 'logstash-file'],\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``\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/vklochan/python-logstash", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "python-logstash-g", "package_url": "https://pypi.org/project/python-logstash-g/", "platform": "", "project_url": "https://pypi.org/project/python-logstash-g/", "project_urls": { "Homepage": "https://github.com/vklochan/python-logstash" }, "release_url": "https://pypi.org/project/python-logstash-g/0.7.0/", "requires_dist": null, "requires_python": "", "summary": "Python logging handler for Logstash.", "version": "0.7.0" }, "last_serial": 5143972, "releases": { "0.6.0": [ { "comment_text": "", "digests": { "md5": "c6acc6ccc31fa30b638e2ff40eb74441", "sha256": "31faba686c9d2c447dbfd7af6d935e050e3405a6831f84784a4483d0f85e2c4d" }, "downloads": -1, "filename": "python_logstash_g-0.6.0-py3-none-any.whl", "has_sig": false, "md5_digest": "c6acc6ccc31fa30b638e2ff40eb74441", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 9759, "upload_time": "2019-01-17T14:06:55", "url": "https://files.pythonhosted.org/packages/24/b9/588409bc198ac2d1a2485b171724711ee65877704acd207f0bdbf823c786/python_logstash_g-0.6.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "721e7fbec39837636ab370fdc459c930", "sha256": "d9b4750478e6ed4f347d634c9b888951e3403079908fb06993aa974b885cfdfb" }, "downloads": -1, "filename": "python-logstash-g-0.6.0.tar.gz", "has_sig": false, "md5_digest": "721e7fbec39837636ab370fdc459c930", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8745, "upload_time": "2019-01-17T14:06:57", "url": "https://files.pythonhosted.org/packages/76/a0/accead04741a052cf3c35cbf87bbcb550fff0083d1ea3ccfd0105cc5d515/python-logstash-g-0.6.0.tar.gz" } ], "0.6.1.1": [ { "comment_text": "", "digests": { "md5": "fabf28cfcfdacc3455afad140f8417b9", "sha256": "757dffded6e3bf9f8b2e82af42c3a60b9aa162310c91217d71ad3cc7538dae99" }, "downloads": -1, "filename": "python_logstash_g-0.6.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "fabf28cfcfdacc3455afad140f8417b9", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 9903, "upload_time": "2019-02-15T08:15:40", "url": "https://files.pythonhosted.org/packages/fc/80/ce815db66c3a0654581a67b81f03c2eca07b4e652c8e23da3013a5748c6c/python_logstash_g-0.6.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "73aee4911a0f7a54f4156c06bae96c1b", "sha256": "363cfb09216f47a7cc84f56b23d61fe4f9a311c6e398824bec571023660d8584" }, "downloads": -1, "filename": "python-logstash-g-0.6.1.1.tar.gz", "has_sig": false, "md5_digest": "73aee4911a0f7a54f4156c06bae96c1b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8963, "upload_time": "2019-02-15T08:15:42", "url": "https://files.pythonhosted.org/packages/b8/3b/22fe88c354101ae150ceee695bf9ff56df6a26c807a2e244a5e57227e492/python-logstash-g-0.6.1.1.tar.gz" } ], "0.6.2": [ { "comment_text": "", "digests": { "md5": "64693249e8d9ad0de29b1dd2e9c213a9", "sha256": "85b7e26d1489c2641a8034be8c8440a8f214f298c26b0174b2bc021adc300b5d" }, "downloads": -1, "filename": "python_logstash_g-0.6.2-py3-none-any.whl", "has_sig": false, "md5_digest": "64693249e8d9ad0de29b1dd2e9c213a9", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 9950, "upload_time": "2019-02-20T02:29:48", "url": "https://files.pythonhosted.org/packages/b1/18/2f41bb70d5d8c85965aa13e0319ed875ac1c8d6819ff2b0c9db6b488acc2/python_logstash_g-0.6.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "4780bef7784286669b6132af96df37e6", "sha256": "bae3901d53b4c7f032c851d2ae26d60065cf73e81288a68ea2191f2d5bf168b1" }, "downloads": -1, "filename": "python-logstash-g-0.6.2.tar.gz", "has_sig": false, "md5_digest": "4780bef7784286669b6132af96df37e6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9014, "upload_time": "2019-02-20T02:29:50", "url": "https://files.pythonhosted.org/packages/90/a4/c685991a91f2a7c616f7709e8d1b6adb210b17e035675205cde4968036a9/python-logstash-g-0.6.2.tar.gz" } ], "0.7.0": [ { "comment_text": "", "digests": { "md5": "03eba4d20a88de7a648212ecdb2c43b6", "sha256": "82bb212e8a365de0324f90f40c77a100f7529ead0c82050dc5600e4a5bce8aec" }, "downloads": -1, "filename": "python_logstash_g-0.7.0-py3-none-any.whl", "has_sig": false, "md5_digest": "03eba4d20a88de7a648212ecdb2c43b6", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 9954, "upload_time": "2019-04-15T10:11:15", "url": "https://files.pythonhosted.org/packages/ea/77/9d0c727689f7405edc5546efcf978c4e3c3fe2fb89d158ed98ece4b5f16f/python_logstash_g-0.7.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "cf3f2bb8162395eb87f76e01a4e1a382", "sha256": "53edf318c90897675c6bb8b3661720be1de1ea6ab1b551907cc8f58198726a4c" }, "downloads": -1, "filename": "python-logstash-g-0.7.0.tar.gz", "has_sig": false, "md5_digest": "cf3f2bb8162395eb87f76e01a4e1a382", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9034, "upload_time": "2019-04-15T10:11:17", "url": "https://files.pythonhosted.org/packages/4f/ae/3a895aed0bfbfcee14305fb24ec9962de56f11213a0004a55ba0d9d0f83a/python-logstash-g-0.7.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "03eba4d20a88de7a648212ecdb2c43b6", "sha256": "82bb212e8a365de0324f90f40c77a100f7529ead0c82050dc5600e4a5bce8aec" }, "downloads": -1, "filename": "python_logstash_g-0.7.0-py3-none-any.whl", "has_sig": false, "md5_digest": "03eba4d20a88de7a648212ecdb2c43b6", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 9954, "upload_time": "2019-04-15T10:11:15", "url": "https://files.pythonhosted.org/packages/ea/77/9d0c727689f7405edc5546efcf978c4e3c3fe2fb89d158ed98ece4b5f16f/python_logstash_g-0.7.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "cf3f2bb8162395eb87f76e01a4e1a382", "sha256": "53edf318c90897675c6bb8b3661720be1de1ea6ab1b551907cc8f58198726a4c" }, "downloads": -1, "filename": "python-logstash-g-0.7.0.tar.gz", "has_sig": false, "md5_digest": "cf3f2bb8162395eb87f76e01a4e1a382", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9034, "upload_time": "2019-04-15T10:11:17", "url": "https://files.pythonhosted.org/packages/4f/ae/3a895aed0bfbfcee14305fb24ec9962de56f11213a0004a55ba0d9d0f83a/python-logstash-g-0.7.0.tar.gz" } ] }