{ "info": { "author": "Alex Krzos", "author_email": "akrzos@redhat.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "Intended Audience :: Information Technology", "Intended Audience :: System Administrators", "License :: OSI Approved :: Apache Software License", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.5", "Topic :: System :: Monitoring" ], "description": "Collectd Gnocchi Status\n=======================\n\n|collectd-gnocchi-status|\n\nOverview\n--------\n\nThis plugin provides valuable insight into your metrics and measures\nbacklog of Gnocchi when installed in an OpenStack environment. It costs\nan API call to Gnocchi status API every $interval (set in the collectd\nconfig file per the plugin). Gnocchi is a component of the OpenStack\nTelemetry project for Metric-as-a-Service.\n\nSample Graph\n------------\n\n.. figure:: https://github.com/akrzos/collectd-gnocchi-status/blob/master/sample-gnocchi-status-collectd.png\n :alt: Sample Graph\n\nConfiguration\n-------------\n\n1. Assuming you have collectd installed already, append the following\n plugin details to your collectd.conf config file\n\n ::\n\n ```\n \n Globals true\n \n\n \n LogTraces true\n Interactive false\n Import \"collectd_gnocchi_status\"\n \n interval 30\n \n \n ```\n\n2. Setup your environment variables in the collectd systemd unit file\n\n ::\n\n ```\n # Populate the following variables with your stackrc/overcloudrc or openstackrc file\n # Tenant v1&v2 api, project for v3 api\n Environment=OS_TENANT_NAME=admin\n Environment=OS_PROJECT_NAME=admin\n\n Environment=OS_PASSWORD=xxxxxxxxxxxxxxxxxxxxxxxxx\n Environment=OS_USERNAME=admin\n Environment=OS_AUTH_URL=http://x.x.x.x:5000/v2.0\n Environment=OS_CLOUDNAME=overcloud\n Environment=OS_NO_CACHE=True\n # End Environment variables to configure\n ```\n\n3. Install plugin\n\n ::\n\n ```\n [root@overcloud-controller-0 ~]# pip install collectd-gnocchi-status\n ```\n\n4. Reload Systemd units\n\n ::\n\n [root@overcloud-controller-0 ~]# systemctl daemon-reload\n\n5. Restart collectd\n\n ::\n\n [root@overcloud-controller-0 ~]# systemctl restart collectd\n\n6. View metrics on Gnocchi in your TSDB\n\nGraphite storage-aggregation.conf Example\n-----------------------------------------\n\nIncluded in the repo is an example Graphite storage-aggregation.conf\n(sample-storage-aggregation.conf) to ensure that your Gnocchi status\nmetrics are not lost due to your retention sizing (Ex.\n10s:7d,60s:90d,1h:180d) < the interval (30s) this plugin is set to\ncollect and publish samples. Simply copy and paste the example, into\nyour /etc/carbon/storage-aggregation.conf file on your Graphite server\nprior to pushing these metrics and restart carbon-cache to reload this\nconfiguration. If the metrics have already been pushed, you must either\nuse whisper-resize (included with Graphite) or remove the corresponding\nwhisper files after restarting carbon-cache to allow carbon to rebuild\nthem with the new parameters in storage-aggregation.conf.\n\nResources\n---------\n\n1. `Gnocchi.xyz`_\n2. `Collectd.org`_\n\n.. _Gnocchi.xyz: http://gnocchi.xyz/\n.. _Collectd.org: https://collectd.org/\n\n.. |collectd-gnocchi-status| image:: https://img.shields.io/pypi/v/collectd-gnocchi-status.svg\n :target: https://pypi.python.org/pypi/collectd-gnocchi-status", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/akrzos/collectd-gnocchi-status", "keywords": "", "license": "Apache-2", "maintainer": "", "maintainer_email": "", "name": "collectd-gnocchi-status", "package_url": "https://pypi.org/project/collectd-gnocchi-status/", "platform": "", "project_url": "https://pypi.org/project/collectd-gnocchi-status/", "project_urls": { "Homepage": "https://github.com/akrzos/collectd-gnocchi-status" }, "release_url": "https://pypi.org/project/collectd-gnocchi-status/0.2.2/", "requires_dist": null, "requires_python": "", "summary": "Collectd plugin to poll for Gnocchi Status.", "version": "0.2.2" }, "last_serial": 3018674, "releases": { "0.2.0": [ { "comment_text": "", "digests": { "md5": "c3a6d681e3500cb62465bd03c6752912", "sha256": "cefa17d4b007fe16157de5eb7ee5f1a9d6bc03f6843b8a04908dfaa6b50e4460" }, "downloads": -1, "filename": "collectd-gnocchi-status-0.2.0.tar.gz", "has_sig": false, "md5_digest": "c3a6d681e3500cb62465bd03c6752912", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3716, "upload_time": "2017-03-24T21:12:00", "url": "https://files.pythonhosted.org/packages/59/2f/30a5642a88cbc37849f629abfd6ce711baf8f553af7b80ca403a4dc274fd/collectd-gnocchi-status-0.2.0.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "a9876efbbfdb61acf91f0c011a980243", "sha256": "15cee6adfd661d01c5a08136a82f09925061af68c721c25e5f4263cac09c9ea5" }, "downloads": -1, "filename": "collectd-gnocchi-status-0.2.1.tar.gz", "has_sig": false, "md5_digest": "a9876efbbfdb61acf91f0c011a980243", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3778, "upload_time": "2017-06-27T17:00:52", "url": "https://files.pythonhosted.org/packages/28/e3/f5b796edf47907a4faa58f00cef62f9896445b7b28243284a445b8c118a2/collectd-gnocchi-status-0.2.1.tar.gz" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "fc48054cb3638d640286a614aa4066fd", "sha256": "3db62d5771024157635531cd5464c227b84ca7e90419f74ff11163b08cf23d5a" }, "downloads": -1, "filename": "collectd-gnocchi-status-0.2.2.tar.gz", "has_sig": false, "md5_digest": "fc48054cb3638d640286a614aa4066fd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 51777, "upload_time": "2017-07-12T20:48:10", "url": "https://files.pythonhosted.org/packages/6c/60/f50cedf1339fab72c7133582e2789c55621cd0fb10a109ee21ffc521f008/collectd-gnocchi-status-0.2.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "fc48054cb3638d640286a614aa4066fd", "sha256": "3db62d5771024157635531cd5464c227b84ca7e90419f74ff11163b08cf23d5a" }, "downloads": -1, "filename": "collectd-gnocchi-status-0.2.2.tar.gz", "has_sig": false, "md5_digest": "fc48054cb3638d640286a614aa4066fd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 51777, "upload_time": "2017-07-12T20:48:10", "url": "https://files.pythonhosted.org/packages/6c/60/f50cedf1339fab72c7133582e2789c55621cd0fb10a109ee21ffc521f008/collectd-gnocchi-status-0.2.2.tar.gz" } ] }