{ "info": { "author": "Murat Knecht", "author_email": "muratk@engagespark.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Programming Language :: Python" ], "description": "===========\n sd-ironmq\n===========\n\nA plugin for the `Server Density `_ agent that monitors `IronMQ queues `_ **using API version 3**.\n\n`PyPI page `_ | `GitHub project `_\n\nFor details how to write one, read the `official docs on plugins `_. Or find more `official plugins `_.\n\nFeatures\n========\n\n- Monitors all queues of the given projects.\n- Recorded metrics:\n - size (key: ::size)\n - total_messages (key: ::size)\n\nExample for metric keys::\n\n billingproject:invoicequeue:size\n billingproject:invoicequeue:total_messages\n\nHow to use\n==========\n\nInstall via PyPI or \u2026\n---------------------\n\nGet it from pypi, installing it somewhere::\n\n pip install sd-ironmq\n\nSymlink it to your plugin directory, on Debian/Ubuntu by default: `/usr/bin/sd-agent/plugins`\n\nInstall via curl\n----------------\n\n`curl` the latest version from GitHub directly into your Plugin directory::\n\n curl https://raw.githubusercontent.com/engagespark/sd-ironmq/master/IronMQ.py > /usr/bin/sd-agent/plugins/IronMQ.py\n\nConfigure\n---------\n\nAdd this section to your `/etc/sd-agent/config.cfg`::\n\n [IronMQ]\n host=mq-aws-eu-west-1-1.iron.io\n # comma separated list of project IDs\n project_ids=\n token=\n\nRestart the agent\n-----------------\n\nOn Debian/Ubuntu::\n\n service sd-agent restart\n\nOther configuration options\n===========================\n\nMetric Keys: Use Project Names instead of IDs\n---------------------------------------------\n\nLet's say you configured the queues of your billing project to be monitored::\n\n project_ids=2342934839ai239ai89i\n\nFor a queue `invoices`, the metric keys would look like so::\n\n 2342934839ai239ai89i:invoices:size\n 2342934839ai239ai89i:invoices:total_messages\n\nThat's not beautiful, nor understandable. Also it exposes IronMQ internals unnecessarily. Configure a name for the project ID like so::\n\n 2342934839ai239ai89i.name=billing\n\nThe name is then used in the keys::\n\n billing:invoices:size\n billing:invoices:total_messages\n\nTest locally\n============\n\nCreate an example.cfg in the working directory::\n\n [IronMQ]\n host=mq-aws-eu-west-1-1.iron.io\n project_ids=\n token=\n\nRun the plugin::\n\n python IronMQ.py\n\n\nReleasing\n=========\n\nPrepare\n-------\n\n#. Install `twine `_ and `wheel `_::\n\n $ pip install -r requirements_dev.txt\n\n#. Setup your `.pypirc `_.\n\nRelease a new version\n---------------------\n\n#. Update CHANGELOG.\n#. Update version in setup.py, commit, push.\n#. Tag as that version, see `git tag`, `push --tags`\n#. Build distributables::\n\n $ python setup.py sdist bdist_wheel\n\n#. Upload distributable to PyPI::\n\n $ twine upload --sign dist/*\n\n\nLicense\n=======\n\nMIT, see `LICENSE `_ file, Copyright `engageSPARK `_", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/engagespark/sd-ironmq", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "sd-ironmq", "package_url": "https://pypi.org/project/sd-ironmq/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/sd-ironmq/", "project_urls": { "Homepage": "https://github.com/engagespark/sd-ironmq" }, "release_url": "https://pypi.org/project/sd-ironmq/0.1.2/", "requires_dist": [ "iron-mq-v3", "requests" ], "requires_python": "", "summary": "Server Density plugin to monitor IronMQs", "version": "0.1.2" }, "last_serial": 1759420, "releases": { "0.1.1": [ { "comment_text": "", "digests": { "md5": "29c4260fc13574cdbc77a6cddd133144", "sha256": "abe8ead3fc4b855e354876fde1c02ad85c09dedd77d0219d5332be58fca34d1e" }, "downloads": -1, "filename": "sd_ironmq-0.1.1-py2-none-any.whl", "has_sig": true, "md5_digest": "29c4260fc13574cdbc77a6cddd133144", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 6069, "upload_time": "2015-10-09T04:44:45", "url": "https://files.pythonhosted.org/packages/4a/c4/3cdc74da9822b3250cae5a50bcd222c7b226639fcae6641374b26ad31002/sd_ironmq-0.1.1-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "30f5a54060866240dd4e737704f12b9e", "sha256": "22fa60e4d3878b283e95bddd5f0d0d0c53f88149b62c0faea4b0e0c2aec74294" }, "downloads": -1, "filename": "sd-ironmq-0.1.1.tar.gz", "has_sig": true, "md5_digest": "30f5a54060866240dd4e737704f12b9e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3894, "upload_time": "2015-10-09T04:44:50", "url": "https://files.pythonhosted.org/packages/15/c8/3432487bc3187b13bbfd5cb1c1bc0e6525dad18d1e40043d3ff1b8e6644f/sd-ironmq-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "526af310395ed855a008538790684d8c", "sha256": "775abdc99562cfa160168164a6d35648257c00bb42d3dfaef78ca05ef5f73ca8" }, "downloads": -1, "filename": "sd_ironmq-0.1.2-py2-none-any.whl", "has_sig": true, "md5_digest": "526af310395ed855a008538790684d8c", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 6165, "upload_time": "2015-10-09T06:13:38", "url": "https://files.pythonhosted.org/packages/a8/84/1f7ae413025d77ec1c41002f20692fb4ee35f574eb2c07f24efced9f0d75/sd_ironmq-0.1.2-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "bc24a2aea81362eb3bb03e0311c4f2bb", "sha256": "2387a4b619b7c8d491606392c1dafaa4d0cdb4801765694977d6a97b61f14251" }, "downloads": -1, "filename": "sd-ironmq-0.1.2.tar.gz", "has_sig": true, "md5_digest": "bc24a2aea81362eb3bb03e0311c4f2bb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4084, "upload_time": "2015-10-09T06:13:42", "url": "https://files.pythonhosted.org/packages/c6/4c/95b1b2f7ad35a2bb85e15465e168c28854604d55a0a27c49b28bac5c3e85/sd-ironmq-0.1.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "526af310395ed855a008538790684d8c", "sha256": "775abdc99562cfa160168164a6d35648257c00bb42d3dfaef78ca05ef5f73ca8" }, "downloads": -1, "filename": "sd_ironmq-0.1.2-py2-none-any.whl", "has_sig": true, "md5_digest": "526af310395ed855a008538790684d8c", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 6165, "upload_time": "2015-10-09T06:13:38", "url": "https://files.pythonhosted.org/packages/a8/84/1f7ae413025d77ec1c41002f20692fb4ee35f574eb2c07f24efced9f0d75/sd_ironmq-0.1.2-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "bc24a2aea81362eb3bb03e0311c4f2bb", "sha256": "2387a4b619b7c8d491606392c1dafaa4d0cdb4801765694977d6a97b61f14251" }, "downloads": -1, "filename": "sd-ironmq-0.1.2.tar.gz", "has_sig": true, "md5_digest": "bc24a2aea81362eb3bb03e0311c4f2bb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4084, "upload_time": "2015-10-09T06:13:42", "url": "https://files.pythonhosted.org/packages/c6/4c/95b1b2f7ad35a2bb85e15465e168c28854604d55a0a27c49b28bac5c3e85/sd-ironmq-0.1.2.tar.gz" } ] }