{ "info": { "author": "Carson Gee", "author_email": "x@carsongee.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 2 - Pre-Alpha", "Intended Audience :: Information Technology", "License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)", "Operating System :: POSIX :: Linux" ], "description": "zenoss-hipchat\n==============\n\nCommand suitable in use for Zenoss notification commands for sending events to hipchat.\n\n\nInstallation\n------------\n\nSimply install using your preferred python package manager with\neither: \n\n``pip install zenoss-hipchat``\n\nfor the latest release, or\n\n``pip install -e git+https://github.com/carsongee/zenoss-hipchat#egg=zenoss-hipchat``\n\nfor the latest development version.\n\n\nConfiguration\n-------------\n\nIn Zenoss go to ``Events`` -> ``Triggers`` and create a trigger with\nthe rules for which you want to send events to hipchat. Of course you\ncan use an existing trigger as well. For more detailed guide on\ntriggers and notifications see the `community documentation\n`_.\n\nAfter you have a trigger you wish to use, go to ``notifications`` and\ncreate a new notification. Set the ``Id`` to something memorable like\n`HipChatErrors` or similar and choose ``Command`` as the action.\n\nAfter creating the notification, edit it. On the ``Notification`` tab\nconfigure it as you see fit, but you are generally going to want to\nmake sure it is enabled, and that you have added the Trigger you\ncreated earlier. The command does support clear messages, so go ahead\nand check that option if you like.\n\nNow on the ``Content`` tab of the notification paste the following\ninto the ``Command`` field:\n\n.. code-block:: bash\n\n zenoss-hipchat --device=\"${evt/device}\" --info=${evt/summary} --component=\"${evt/component}\" --severity=${evt/severity} --url=\"${urls/eventUrl}\" --message=${evt/message}\n\nAnd if you want to use the clear option, for the clear command:\n\n.. code-block:: bash\n\n zenoss-hipchat --device=\"${evt/device}\" --info=${evt/summary} --component=\"${evt/component}\" --severity=${evt/severity} --url=\"${urls/eventUrl}\" --message=${evt/message} --cleared-by=\"${evt/clearid}\" --clear\n\nYou also need to provide the room and API token using the\n``Environment variables`` field with something like:\n\n.. code-block:: bash\n\n HIPCHAT_TOKEN=;HIPCHAT_ROOM=\n\nreplacing the values with ones appropriate for you.\n\n\nAdditional Environment Variables\n--------------------------------\n\nIn addition to ``HIPCHAT_TOKEN`` and ``HIPCHAT_ROOM`` which are\nrequired, you can also override other options with the following\noptional environment variables:\n\n- ``HIPCHAT_API_V1_ENDPOINT`` - Allows you to override the API\n endpoint if you are using private HipChat\n- ``HIPCHAT_FROM`` - Defaults to Zenoss, and determines who the\n messages appear to be coming from.\n- ``HIPCHAT_TIMEOUT`` - Defaults to 3 seconds, but if you have a slow\n connection to the HipChat server it can be increased or decreased.\n- ``HIPCHAT_NOTIFY_SEVERITY`` - Defaults to Error and above (4), but\n can raised or lowered and determines which events trigger the\n HipChat notification.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/carsongee/zenoss-hipchat", "keywords": null, "license": "GPLv3", "maintainer": null, "maintainer_email": null, "name": "zenoss-hipchat", "package_url": "https://pypi.org/project/zenoss-hipchat/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/zenoss-hipchat/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://github.com/carsongee/zenoss-hipchat" }, "release_url": "https://pypi.org/project/zenoss-hipchat/0.2.0/", "requires_dist": null, "requires_python": null, "summary": "Command suitable in use for Zenoss notification commands for sending events to hipchat.", "version": "0.2.0" }, "last_serial": 1344783, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "b934977b4d3e4c49f899f578e56b61de", "sha256": "0d83c227bb278585f1d7f6540a2f9bb164e33012c53105198e218b9f0d53c687" }, "downloads": -1, "filename": "zenoss-hipchat-0.1.0.tar.gz", "has_sig": false, "md5_digest": "b934977b4d3e4c49f899f578e56b61de", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4419, "upload_time": "2014-11-30T20:58:11", "url": "https://files.pythonhosted.org/packages/c0/7b/e790d4c98e943978844c52e337bd6fe3323192faed14a740d48426dad647/zenoss-hipchat-0.1.0.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "d45682747f6c0a39a8c4e541697869f5", "sha256": "1460b867e8e364bfc4b75dfc912d20a6e7ae0313ddadbb35d9480865b293bfab" }, "downloads": -1, "filename": "zenoss-hipchat-0.2.0.tar.gz", "has_sig": false, "md5_digest": "d45682747f6c0a39a8c4e541697869f5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4742, "upload_time": "2014-12-15T18:01:52", "url": "https://files.pythonhosted.org/packages/ad/00/23c6eff7e57f7feb388a42133f721d9231ad69f780dbc5605c74c61703de/zenoss-hipchat-0.2.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "d45682747f6c0a39a8c4e541697869f5", "sha256": "1460b867e8e364bfc4b75dfc912d20a6e7ae0313ddadbb35d9480865b293bfab" }, "downloads": -1, "filename": "zenoss-hipchat-0.2.0.tar.gz", "has_sig": false, "md5_digest": "d45682747f6c0a39a8c4e541697869f5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4742, "upload_time": "2014-12-15T18:01:52", "url": "https://files.pythonhosted.org/packages/ad/00/23c6eff7e57f7feb388a42133f721d9231ad69f780dbc5605c74c61703de/zenoss-hipchat-0.2.0.tar.gz" } ] }