{ "info": { "author": "Rapid7", "author_email": "InsightOpsTeam@rapid7.com", "bugtrack_url": null, "classifiers": [ "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 2", "Programming Language :: Python :: 3" ], "description": "Rapid7 Insight Logger\n=====================\n\nThis is a plugin library to enable logging to Rapid7 Insight from the Python Logger.\nAdditionally this plugin allows the user to get an overview of methods being executed,\ntheir execution time, as well as CPU and Memory statistics.\nMore info at https://www.rapid7.com/solutions/it-operations/. Note that this plugin is\n**asynchronous**.\n\nSetup\n-----\n\nTo use this library, you must first create an account on Rapid7 Insight.\nThis will only take a few moments.\n\nInstall\n-------\n\nTo install this library, use the following command:\n\n``pip install r7insight_python``\n\nUsage\n-----\n\n.. code-block:: python\n\n #!/usr/bin/env python\n\n import logging\n from r7insight import R7InsightHandler\n\n\n log = logging.getLogger('r7insight')\n log.setLevel(logging.INFO)\n test = R7InsightHandler(TOKEN, REGION)\n\n log.addHandler(test)\n\n log.warn(\"Warning message\")\n log.info(\"Info message\")\n\n sleep(10)\n\n\nUsage with metric functionality\n-------------------------------\n\n.. code-block:: python\n\n import time\n import logging\n from r7insight import R7InsightHandler, metrics\n\n\n TEST = metrics.Metric(TOKEN, REGION)\n\n @TEST.metric()\n def function_one(t):\n \"\"\"A dummy function that takes some time.\"\"\"\n time.sleep(t)\n\n if __name__ == '__main__':\n function_one(1)\n\n\nMetric.Time()\n-------------\n\nThis decorator function is used to log the execution time of given function. In the above example ``@TEST.time()`` will wrap ``function_one`` and send log message containing the name and execution time of this function.\n\nConfigure\n---------\n\nThe parameter ``TOKEN`` needs to be filled in to point to a\nfile in your Insight account.\n\nThe parameter ``REGION`` needs to be filled with the region your log is located in. i.e: 'eu', 'us'\n\nIn your R7Insight account, create a logfile, selecting ``Token TCP`` as\nthe source\\_type. This will print a Token UUID. This\nis the value to use for ``TOKEN``.\n\nThe appender will attempt to send your log data over TLS over port 443. You can also choose to not\nuse TLS, in which case it will be sent over port 80.\nIf the ``allow_plaintext_fallback`` option in the constructor is set to ``True``, then the library\nwill automatically fall back to an insecure connection on port 80 if TLS is not supported on the\nhost system.\n\nYou are now ready to start logging.\n\nContact Support\n===============\n\nPlease email our support team at support@rapid7.com if you need any help.\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://pypi.python.org/pypi/R7Insight/", "keywords": "", "license": "LICENSE.txt", "maintainer": "", "maintainer_email": "", "name": "r7insight-python", "package_url": "https://pypi.org/project/r7insight-python/", "platform": "", "project_url": "https://pypi.org/project/r7insight-python/", "project_urls": { "Homepage": "http://pypi.python.org/pypi/R7Insight/" }, "release_url": "https://pypi.org/project/r7insight-python/1.0.0/", "requires_dist": [ "certifi" ], "requires_python": "", "summary": "Python Logger plugin to send logs to Rapid7 Insight", "version": "1.0.0" }, "last_serial": 4721782, "releases": { "0.9": [ { "comment_text": "", "digests": { "md5": "c362aa7980e47a355a14f9e318ac293a", "sha256": "b56d41ead17a0708d5d99f003d58c78f0bc4e2d49e233c133bb2efd5a9a9fb49" }, "downloads": -1, "filename": "r7insight_python-0.9.tar.gz", "has_sig": false, "md5_digest": "c362aa7980e47a355a14f9e318ac293a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5573, "upload_time": "2017-06-21T13:55:20", "url": "https://files.pythonhosted.org/packages/d8/67/00fa76e53383290e54df21bb34e2b1795b922f0b3fa9bb500f0f00228810/r7insight_python-0.9.tar.gz" } ], "0.9.1": [ { "comment_text": "", "digests": { "md5": "052f212e83ba216ec06b36e919d6265e", "sha256": "8618f78f07c26de876d3f8c81e2b2f68e5356efe5794be56a43f6a15adf6edf8" }, "downloads": -1, "filename": "r7insight_python-0.9.1.tar.gz", "has_sig": false, "md5_digest": "052f212e83ba216ec06b36e919d6265e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5460, "upload_time": "2018-04-03T10:59:59", "url": "https://files.pythonhosted.org/packages/cd/e1/90abc749df5306dd99879f9a3312beaacefa662f57fe1c922a5e98c2103b/r7insight_python-0.9.1.tar.gz" } ], "0.9.2": [ { "comment_text": "", "digests": { "md5": "afb5c296ebb0890036bf704a1b07f4bd", "sha256": "e8eaf8c763d871552d033e2557a38f5224b751b84062d13d522bb47f1e21aa6b" }, "downloads": -1, "filename": "r7insight_python-0.9.2.tar.gz", "has_sig": false, "md5_digest": "afb5c296ebb0890036bf704a1b07f4bd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5454, "upload_time": "2018-04-05T16:00:17", "url": "https://files.pythonhosted.org/packages/ba/f7/80d2af8e204afd67eba78d028be107555a7d2b22b800f735037b142c7280/r7insight_python-0.9.2.tar.gz" } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "ea72e64bae0bd8a63896a822cd6f5041", "sha256": "9300e6466a6b79ebd0d6f4e76b7985b1fd2f4e14809d7ce5a237c964faec15ed" }, "downloads": -1, "filename": "r7insight_python-1.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "ea72e64bae0bd8a63896a822cd6f5041", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 6422, "upload_time": "2019-01-21T14:07:50", "url": "https://files.pythonhosted.org/packages/8a/00/4b5a21178ee0139ff0458424eba0b82935b1f93054189bc951a7eda3145e/r7insight_python-1.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "7c040a17dbc33d87f2f50bfd2928c852", "sha256": "96c0e214a3a5b09d208f10368fa48402355c65a6181bc95a618f934c139322d9" }, "downloads": -1, "filename": "r7insight_python-1.0.0.tar.gz", "has_sig": false, "md5_digest": "7c040a17dbc33d87f2f50bfd2928c852", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5648, "upload_time": "2019-01-21T14:07:51", "url": "https://files.pythonhosted.org/packages/77/ed/b3a4f2c8e16717f0d97ca92709b0d39de0f94bec36a58dbca6d87afcec78/r7insight_python-1.0.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "ea72e64bae0bd8a63896a822cd6f5041", "sha256": "9300e6466a6b79ebd0d6f4e76b7985b1fd2f4e14809d7ce5a237c964faec15ed" }, "downloads": -1, "filename": "r7insight_python-1.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "ea72e64bae0bd8a63896a822cd6f5041", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 6422, "upload_time": "2019-01-21T14:07:50", "url": "https://files.pythonhosted.org/packages/8a/00/4b5a21178ee0139ff0458424eba0b82935b1f93054189bc951a7eda3145e/r7insight_python-1.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "7c040a17dbc33d87f2f50bfd2928c852", "sha256": "96c0e214a3a5b09d208f10368fa48402355c65a6181bc95a618f934c139322d9" }, "downloads": -1, "filename": "r7insight_python-1.0.0.tar.gz", "has_sig": false, "md5_digest": "7c040a17dbc33d87f2f50bfd2928c852", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5648, "upload_time": "2019-01-21T14:07:51", "url": "https://files.pythonhosted.org/packages/77/ed/b3a4f2c8e16717f0d97ca92709b0d39de0f94bec36a58dbca6d87afcec78/r7insight_python-1.0.0.tar.gz" } ] }