{ "info": { "author": "Brett Langdon", "author_email": "me@brett.is", "bugtrack_url": null, "classifiers": [ "Environment :: Web Environment", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "Flask-Graylog\n=============\n\nThis is a Flask_ extension that allows you to configure a Graylog_ log handler as well as configuring middleware to log every request/response to Graylog.\n\n.. _Flask: http://flask.pocoo.org/\n.. _Graylog: https://graylog.org\n\nInstallation\n------------\n\nYou can install it via `pip`:\n\n.. code:: bash\n\n pip install Flask-Graylog\n\n\nUsage\n-----\n\nYou only need to import and initialize your app\n\n.. code:: python\n\n # Import dependencies\n from flask import Flask\n from flask.ext.graylog import Graylog\n\n # Configure app and Graylog logger\n app = Flask(__name__)\n graylog = Graylog(app)\n\n # Log to graylog\n graylog.info('Message', extra={\n 'extra': 'metadata',\n })\n\n # Use graylog log handler in another logger\n import logging\n logger = logging.getLogger(__name__)\n logger.addHandler(graylog.handler)\n logger.info('Message')\n\n\nConfiguration options\n~~~~~~~~~~~~~~~~~~~~~\n\nThe following options can be use to configure the graylog logger.\n\n.. code:: python\n\n from flask import Flask\n from flask.ext.graylog import Graylog\n\n app = Flask(__name__)\n\n # Use configuration from `app`\n app.config['GRAYLOG_HOST'] = '10.1.1.1'\n graylog = Graylog(app)\n\n # Provide configuration\n config = {'GRAYLOG_HOST': '10.1.1.1'}\n graylog = Graylog(app, config=config)\n\n* ``GRAYLOG_HOST`` - the host to send messages to [default: 'localhost']\n* ``GRAYLOG_PORT`` - the port to send messages to [default: 12201]\n* ``GRAYLOG_FACILITY`` - the facility to report with [default: 'flask']\n* ``GRAYLOG_EXTRA_FIELDS`` - whether or not to include the `extra` data from each message [default: True]\n* ``GRAYLOG_ADD_DEBUG_FIELDS`` - whether extra python debug fields should be added to each message [default: True]\n* ``GRAYLOG_CONFIGURE_MIDDLEWARE`` - whether to setup middleware to log each response [default: True]\n\n\nExample message format\n~~~~~~~~~~~~~~~~~~~~~~\n\n.. code:: json\n\n {\n \"_process_name\": \"MainProcess\",\n \"_request\": {\n \"content_length\": \"\",\n \"remote_addr\": \"127.0.0.1\",\n \"headers\": {\n \"upgrade_insecure_requests\": \"1\",\n \"connection\": \"keep-alive\",\n \"accept\": \"text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8\",\n \"dnt\": \"1\",\n \"host\": \"localhost:5000\",\n \"user_agent\": \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/49.0.2623.112 Safari/537.36\",\n \"accept_language\": \"en-US,en;q=0.8,ms;q=0.6\",\n \"cache_control\": \"max-age=0\",\n \"accept_encoding\": \"gzip, deflate, sdch\"\n },\n \"path_info\": \"/\",\n \"content_type\": \"\",\n \"query_string\": \"\",\n \"method\": \"GET\"\n },\n \"level\": 6,\n \"_logger\": \"flask_graylog\",\n \"timestamp\": 1460502169.950895,\n \"_pid\": 6010,\n \"facility\": \"flask\",\n \"_function\": \"after_request\",\n \"_thread_name\": \"Thread-1\",\n \"host\": \"voltaire.local\",\n \"version\": \"1.0\",\n \"file\": \"Flask-Graylog/flask_graylog.py\",\n \"full_message\": \"Finishing request for \\\"GET http://localhost:5000/\\\" from -\",\n \"line\": 130,\n \"_response\": {\n \"headers\": {\n \"content_length\": \"6\",\n \"content_type\": \"text/html; charset=utf-8\"\n },\n \"time_ms\": 0,\n \"status_code\": 200\n },\n \"_flask\": {\n \"view_args\": {},\n \"endpoint\": \"root\"\n },\n \"short_message\": \"Finishing request for \\\"GET http://localhost:5000/\\\" from -\"\n }\n\n\n", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/underdogio/flask-graylog.git", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "Flask-Graylog", "package_url": "https://pypi.org/project/Flask-Graylog/", "platform": "any", "project_url": "https://pypi.org/project/Flask-Graylog/", "project_urls": { "Homepage": "https://github.com/underdogio/flask-graylog.git" }, "release_url": "https://pypi.org/project/Flask-Graylog/1.1.2/", "requires_dist": [ "Flask", "graypy" ], "requires_python": "", "summary": "Configure Graylog logging handlers and middleware for your Flask app", "version": "1.1.2" }, "last_serial": 3021158, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "e6a498136ca7ade5f5a3feb446b63dbb", "sha256": "b0b7dc25ff1f34e60c0f0a2bdb342b064bca906cfb3d9384a9817b386cbdbdcb" }, "downloads": -1, "filename": "Flask-Graylog-1.0.0.tar.gz", "has_sig": false, "md5_digest": "e6a498136ca7ade5f5a3feb446b63dbb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3925, "upload_time": "2016-04-12T23:14:18", "url": "https://files.pythonhosted.org/packages/51/3f/313f897589fea33180792b2f4bd1649067e217f165541784e2df780bcbf7/Flask-Graylog-1.0.0.tar.gz" } ], "1.1.0": [ { "comment_text": "", "digests": { "md5": "17d6467a3a862557d581864ee5e827a9", "sha256": "c99f5d5f88edd516af571047a4874b58eca810e2a1914d065dc0991259905af1" }, "downloads": -1, "filename": "Flask_Graylog-1.1.0-py2-none-any.whl", "has_sig": false, "md5_digest": "17d6467a3a862557d581864ee5e827a9", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 4035, "upload_time": "2016-12-09T14:28:15", "url": "https://files.pythonhosted.org/packages/51/7f/e4668b5280b3017f47a7f45e223b39f830b1843e7ebd42ab8ecb497b816d/Flask_Graylog-1.1.0-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "976c0d491925460842eeab944e9f7eca", "sha256": "46e828b9ab3e148b2d85a38574939bfc8d637238e870f1ded9f6b87a6e2ed097" }, "downloads": -1, "filename": "Flask-Graylog-1.1.0.tar.gz", "has_sig": false, "md5_digest": "976c0d491925460842eeab944e9f7eca", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3903, "upload_time": "2016-12-09T14:28:17", "url": "https://files.pythonhosted.org/packages/f9/73/05f9eb8bcb4622b676c302162e0b836cc2fa2e58448db5f6553201408941/Flask-Graylog-1.1.0.tar.gz" } ], "1.1.1": [ { "comment_text": "", "digests": { "md5": "b1d6523a1da81078ec23225a892c29e5", "sha256": "5908a6b4612fcc84e64e7902d8d795c889be0edc13d1415e21a6813e944fca60" }, "downloads": -1, "filename": "Flask_Graylog-1.1.1-py2-none-any.whl", "has_sig": false, "md5_digest": "b1d6523a1da81078ec23225a892c29e5", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 4041, "upload_time": "2017-07-13T18:32:39", "url": "https://files.pythonhosted.org/packages/80/7f/d80aa883d5714b20ca60c2fcfccd7ead14e0f7aea8a6ed0ce98c154cad76/Flask_Graylog-1.1.1-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0ff9388a7449d645b8e90326f7138ebd", "sha256": "d707511f651b8136665c1f2de54e4e67857c328b3a1e06865130640860c8e0a1" }, "downloads": -1, "filename": "Flask_Graylog-1.1.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "0ff9388a7449d645b8e90326f7138ebd", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 6864, "upload_time": "2017-07-13T18:45:16", "url": "https://files.pythonhosted.org/packages/c8/27/b919bef8700f34556ea9aec249ad286b0adc3e27e7e062241916b1ffee66/Flask_Graylog-1.1.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "7e14439b28e9c2ec438a2ce9ebd5ebe3", "sha256": "65cd20124c8295473bea4b1718c52a0823cdae93f953389db6fb68ed4bf3abe0" }, "downloads": -1, "filename": "Flask-Graylog-1.1.1.tar.gz", "has_sig": false, "md5_digest": "7e14439b28e9c2ec438a2ce9ebd5ebe3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3912, "upload_time": "2017-07-13T18:32:40", "url": "https://files.pythonhosted.org/packages/32/04/94a54362021843e623e8bd9d959c553ebb7625e56f59f8f953e784b22497/Flask-Graylog-1.1.1.tar.gz" } ], "1.1.2": [ { "comment_text": "", "digests": { "md5": "73699fcb656e59869f279a1e2f6ad69e", "sha256": "ddf57e1c4b0ed78c8a0ceac49f3013cef569013a8ad46f4f3aac578abd0c6308" }, "downloads": -1, "filename": "Flask_Graylog-1.1.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "73699fcb656e59869f279a1e2f6ad69e", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 6869, "upload_time": "2017-07-13T18:47:26", "url": "https://files.pythonhosted.org/packages/3c/66/b3231b6c7536d3d6d774d74a7d7f40e8b21da277c322a067dfcabcdcfd0f/Flask_Graylog-1.1.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "8486d807fa31fb8a399b58aa038215d0", "sha256": "3261e6b49d61a4412c469e5fe99c1245f4b304066548268ce276a405882e3dc3" }, "downloads": -1, "filename": "Flask-Graylog-1.1.2.tar.gz", "has_sig": false, "md5_digest": "8486d807fa31fb8a399b58aa038215d0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4480, "upload_time": "2017-07-13T18:47:28", "url": "https://files.pythonhosted.org/packages/93/7c/e21ae6b15f1bcbf3fee788bf18230a471230b0bffcc41bc6c7b877fcee42/Flask-Graylog-1.1.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "73699fcb656e59869f279a1e2f6ad69e", "sha256": "ddf57e1c4b0ed78c8a0ceac49f3013cef569013a8ad46f4f3aac578abd0c6308" }, "downloads": -1, "filename": "Flask_Graylog-1.1.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "73699fcb656e59869f279a1e2f6ad69e", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 6869, "upload_time": "2017-07-13T18:47:26", "url": "https://files.pythonhosted.org/packages/3c/66/b3231b6c7536d3d6d774d74a7d7f40e8b21da277c322a067dfcabcdcfd0f/Flask_Graylog-1.1.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "8486d807fa31fb8a399b58aa038215d0", "sha256": "3261e6b49d61a4412c469e5fe99c1245f4b304066548268ce276a405882e3dc3" }, "downloads": -1, "filename": "Flask-Graylog-1.1.2.tar.gz", "has_sig": false, "md5_digest": "8486d807fa31fb8a399b58aa038215d0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4480, "upload_time": "2017-07-13T18:47:28", "url": "https://files.pythonhosted.org/packages/93/7c/e21ae6b15f1bcbf3fee788bf18230a471230b0bffcc41bc6c7b877fcee42/Flask-Graylog-1.1.2.tar.gz" } ] }