{ "info": { "author": "chaostoolkit Team", "author_email": "contact@chaostoolkit.org", "bugtrack_url": null, "classifiers": [ "Development Status :: 2 - Pre-Alpha", "Intended Audience :: Developers", "License :: Freely Distributable", "License :: OSI Approved :: Apache Software License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Programming Language :: Python :: Implementation", "Programming Language :: Python :: Implementation :: CPython" ], "description": "# chaostoolkit-humio\n\n[![Build Status](https://travis-ci.org/chaostoolkit-incubator/chaostoolkit-humio.svg?branch=master)](https://travis-ci.org/chaostoolkit-incubator/chaostoolkit-humio)\n\nThis project is an extension for the Chaos Toolkit to target [Humio][humio].\n\n[humio]: https://www.humio.com/\n\n## Install\n\nThis package requires Python 3.5+\n\nTo be used from your experiment, this package must be installed in the Python\nenvironment where [chaostoolkit][] already lives.\n\n[chaostoolkit]: https://github.com/chaostoolkit/chaostoolkit\n\n```\n$ pip install -U chaostoolkit-humio\n```\n\n## Humio Dataspace & Token\n\nTo use this extension, you will need two pieces of information from Humio.\nFirst, the dataspace which you want to send logs to. Second a [API token][token]\nfor an user with permissions to that space.\n\n[token]: https://cloud.humio.com/docs/http-api/index.html#api-token\n\n## Usage\n\nThis extension can be used a control on the experiment or a notification\nplugin of the Chaos Toolkit CLI itself. Usually, only one of these two methods\nis used at any given time as they serve similar purpose but feel free to\ncombine them. The control approach is deeper because it logs down to the\nactivity whereas notifications are much higher level.\n\n### Notification\n\nTo use this extension to push notifications, edit your\n[chaostoolkit settings][settings] by adding the following payload:\n\n[settings]: http://chaostoolkit.org/reference/usage/settings/\n\n```yaml\nnotifications:\n -\n type: plugin\n module: chaoshumio.notification\n dataspace: my-space\n token: my-token\n```\n\nBy default all events will be forwarded to that channel. You may filter only\nthose events you care for:\n\n\n```yaml\nnotifications:\n -\n type: plugin\n module: chaoshumio.notification\n dataspace: my-space\n token: my-token\n events:\n - run-failed\n - run-started\n```\n\nOnly sends those two events.\n\n### Control\n\nTo use this extension as a control over the experiment and send logs during\nthe execution of the experiment, add the following payload to your experiment:\n\n```json\n{\n \"secrets\": {\n \"humio\": {\n \"token\": {\n \"type\": \"env\",\n \"key\": \"HUMIO_INGEST_TOKEN\"\n },\n \"dataspace\": {\n \"type\": \"env\",\n \"key\": \"HUMIO_DATASPACE\"\n }\n }\n },\n \"controls\": [\n {\n \"name\": \"humio-logger\",\n \"provider\": {\n \"type\": \"python\",\n \"module\": \"chaoshumio.control\",\n \"secrets\": [\"humio\"]\n }\n }\n ]\n}\n```\n\nThis will ensure the results of the experiment, steady-state, method, rollbacks\nand each activity are sent to your space. The experiment itself will also be\nsend initially.\n\n\n## Test\n\nTo run the tests for the project execute the following:\n\n```\n$ pytest\n```\n\n## Contribute\n\nIf you wish to contribute more functions to this package, you are more than\nwelcome to do so. Please, fork this project, make your changes following the\nusual [PEP 8][pep8] code style, sprinkling with tests and submit a PR for\nreview.\n\n[pep8]: https://pycodestyle.readthedocs.io/en/latest/\n\nThe Chaos Toolkit projects require all contributors must sign a\n[Developer Certificate of Origin][dco] on each commit they would like to merge\ninto the master branch of the repository. Please, make sure you can abide by\nthe rules of the DCO before submitting a PR.\n\n[dco]: https://github.com/probot/dco#how-it-works\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://chaostoolkit.org", "keywords": "", "license": "Apache License Version 2.0", "maintainer": "", "maintainer_email": "", "name": "chaostoolkit-humio", "package_url": "https://pypi.org/project/chaostoolkit-humio/", "platform": "", "project_url": "https://pypi.org/project/chaostoolkit-humio/", "project_urls": { "Homepage": "http://chaostoolkit.org" }, "release_url": "https://pypi.org/project/chaostoolkit-humio/0.3.0/", "requires_dist": [ "chaostoolkit-lib (>=1.0.0rc1)", "logzero", "requests" ], "requires_python": ">=3.5.*", "summary": "Chaos Toolkit Humio Extension", "version": "0.3.0" }, "last_serial": 4563966, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "d2e3d8b01be62aae0f6682c745b2d371", "sha256": "73b86ad88a8122e519efc9170728b0e6e35e7757d88fc7c5292bd9225044daf6" }, "downloads": -1, "filename": "chaostoolkit_humio-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "d2e3d8b01be62aae0f6682c745b2d371", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5.*", "size": 5554, "upload_time": "2018-02-21T13:38:13", "url": "https://files.pythonhosted.org/packages/f3/f1/107158a4aa44262911b476f6e2c79b24d4a202cd2ed27069cd61d690b5b1/chaostoolkit_humio-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "10592a98a27f40b44a18c687ce740ed8", "sha256": "e1dc42a4c9d9895f815f871aa0f3af21899c70ef78c2e9633ae8743176564f8c" }, "downloads": -1, "filename": "chaostoolkit-humio-0.1.0.tar.gz", "has_sig": false, "md5_digest": "10592a98a27f40b44a18c687ce740ed8", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5.*", "size": 3587, "upload_time": "2018-02-21T13:38:19", "url": "https://files.pythonhosted.org/packages/e4/de/769cfe4e685527da244b6ca467bd065af781fcf37b1cc36ea91d20df431a/chaostoolkit-humio-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "e6524a5aa1817da51b6f5c92d7240749", "sha256": "aabea6a9c00bf8302cdabffeb0510ede190c4b3107912ff871973793369ded5d" }, "downloads": -1, "filename": "chaostoolkit_humio-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "e6524a5aa1817da51b6f5c92d7240749", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5.*", "size": 5557, "upload_time": "2018-05-14T13:31:54", "url": "https://files.pythonhosted.org/packages/0e/8e/e893077640d333087cefc523981c0c6c7a7e86d9b432393994dfb2b89105/chaostoolkit_humio-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "d7fcbfd540fe9c1cfe41f8db4e6e0ccf", "sha256": "b910b3da030aa3f4bb550a5abbb346c6d754b1c1b5ffd408a521b0cb82f1f5d0" }, "downloads": -1, "filename": "chaostoolkit-humio-0.1.1.tar.gz", "has_sig": false, "md5_digest": "d7fcbfd540fe9c1cfe41f8db4e6e0ccf", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5.*", "size": 8421, "upload_time": "2018-05-14T13:31:55", "url": "https://files.pythonhosted.org/packages/d5/a8/a0ce46189d358d943b4c6760516966a079106df9e336008f5460f1a5be68/chaostoolkit-humio-0.1.1.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "85dbba87145f8a28621d93f1ca2c3d90", "sha256": "8090e9c7253e7fa280c987b50b9ffb5b7b83ba1a553613e749929f2060804377" }, "downloads": -1, "filename": "chaostoolkit_humio-0.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "85dbba87145f8a28621d93f1ca2c3d90", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5.*", "size": 5795, "upload_time": "2018-12-04T14:13:36", "url": "https://files.pythonhosted.org/packages/f0/48/36c812689ce25880727b4c92f6ab36a77f5271c09dd45d07659a708b17f8/chaostoolkit_humio-0.2.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b21d719c9f1fe7ebdf32aa2ab6712fe5", "sha256": "f94fe6026acbe653fcd82e83468bceda5e9711ee496bb748920f9bdb0438e965" }, "downloads": -1, "filename": "chaostoolkit-humio-0.2.0.tar.gz", "has_sig": false, "md5_digest": "b21d719c9f1fe7ebdf32aa2ab6712fe5", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5.*", "size": 11212, "upload_time": "2018-12-04T14:13:38", "url": "https://files.pythonhosted.org/packages/61/50/ae6b15ca4ea38bf8e41dcd3b7c4e2c97d12e21e9ecd8e98b4f3fa11c914a/chaostoolkit-humio-0.2.0.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "3e5f45a25be7cbc3255a142b28f2722b", "sha256": "3b671a86c599e6b34d7f20418328d02f643d1e889640aa2d1ee0037524bc4830" }, "downloads": -1, "filename": "chaostoolkit_humio-0.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "3e5f45a25be7cbc3255a142b28f2722b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5.*", "size": 5974, "upload_time": "2018-12-05T14:15:14", "url": "https://files.pythonhosted.org/packages/d2/60/7a3d58b918b9e3923cfc2a5009fc8ba614a3fd034071bee2afcf2ad0c577/chaostoolkit_humio-0.3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0450030f0d7fa61ed5eba52afb79287f", "sha256": "4cef2e08dab3219623a0927dedaefd067955b25e4e1e5c8ec780ed54b330d6c8" }, "downloads": -1, "filename": "chaostoolkit-humio-0.3.0.tar.gz", "has_sig": false, "md5_digest": "0450030f0d7fa61ed5eba52afb79287f", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5.*", "size": 11370, "upload_time": "2018-12-05T14:15:16", "url": "https://files.pythonhosted.org/packages/80/45/4d13e03911a177625c5b050319f57658e36a12d770a380d873304d146a5d/chaostoolkit-humio-0.3.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "3e5f45a25be7cbc3255a142b28f2722b", "sha256": "3b671a86c599e6b34d7f20418328d02f643d1e889640aa2d1ee0037524bc4830" }, "downloads": -1, "filename": "chaostoolkit_humio-0.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "3e5f45a25be7cbc3255a142b28f2722b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5.*", "size": 5974, "upload_time": "2018-12-05T14:15:14", "url": "https://files.pythonhosted.org/packages/d2/60/7a3d58b918b9e3923cfc2a5009fc8ba614a3fd034071bee2afcf2ad0c577/chaostoolkit_humio-0.3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0450030f0d7fa61ed5eba52afb79287f", "sha256": "4cef2e08dab3219623a0927dedaefd067955b25e4e1e5c8ec780ed54b330d6c8" }, "downloads": -1, "filename": "chaostoolkit-humio-0.3.0.tar.gz", "has_sig": false, "md5_digest": "0450030f0d7fa61ed5eba52afb79287f", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5.*", "size": 11370, "upload_time": "2018-12-05T14:15:16", "url": "https://files.pythonhosted.org/packages/80/45/4d13e03911a177625c5b050319f57658e36a12d770a380d873304d146a5d/chaostoolkit-humio-0.3.0.tar.gz" } ] }