{ "info": { "author": "William Hutson", "author_email": "wilrnh@gmail.com", "bugtrack_url": null, "classifiers": [], "description": "========================\nNagios CloudWatch Plugin\n========================\n\nThis plugin for checks AWS CloudWatch metrics. It uses the popular **boto**\nlibrary to gather metric values. This plugin does not currently have a means of\ndirectly supplying AWS credentials - for this, consult the boto `docs `_.\n\nSetup\n=====\n1. pip install nagios-cloudwatch-plugin\n2. /usr/local/bin/check_cloudwatch.py -h::\n\n\t\tusage: check_cloudwatch.py [-h] -n NAMESPACE -m METRIC [-d DIMENSIONS]\n\t\t [-s {Average,Sum,SampleCount,Maximum,Minimum}]\n\t\t [-p PERIOD] [-l LAG] [-r]\n\t\t [--divisor-namespace DIVISOR_NAMESPACE]\n\t\t [--divisor-metric DIVISOR_METRIC]\n\t\t [--divisor-dimensions DIVISOR_DIMENSIONS]\n\t\t [--divisor-statistic {Average,Sum,SampleCount,Maximum,Minimum}]\n\t\t [--delta DELTA] [-w RANGE] [-c RANGE] [-v]\n\t\t [-R REGION]\n\t\t [-P profile_name]\n\n\t\tNagios plugin to check cloudwatch metrics\n\n\t\toptional arguments:\n\t\t -h, --help show this help message and exit\n\t\t -n NAMESPACE, --namespace NAMESPACE\n\t\t namespace for cloudwatch metric\n\t\t -m METRIC, --metric METRIC\n\t\t metric name\n\t\t -d DIMENSIONS, --dimensions DIMENSIONS\n\t\t dimensions of cloudwatch metric in the format\n\t\t dimension=value[,dimension=value...]\n\t\t -s {Average,Sum,SampleCount,Maximum,Minimum}, --statistic {Average,Sum,SampleCount,Maximum,Minimum}\n\t\t statistic used to evaluate metric\n\t\t -p PERIOD, --period PERIOD\n\t\t the period in seconds over which the statistic is\n\t\t applied\n\t\t -l LAG, --lag LAG delay in seconds to add to starting time for gathering\n\t\t metric. useful for ec2 basic monitoring which\n\t\t aggregates over 5min periods\n\t\t -r, --ratio this activates ratio mode\n\t\t --divisor-namespace DIVISOR_NAMESPACE\n\t\t ratio mode: namespace for cloudwatch metric of the\n\t\t divisor\n\t\t --divisor-metric DIVISOR_METRIC\n\t\t ratio mode: metric name of the divisor\n\t\t --divisor-dimensions DIVISOR_DIMENSIONS\n\t\t ratio mode: dimensions of cloudwatch metric of the\n\t\t divisor\n\t\t --divisor-statistic {Average,Sum,SampleCount,Maximum,Minimum}\n\t\t ratio mode: statistic used to evaluate metric of the\n\t\t divisor\n\t\t --delta DELTA time in seconds to build a delta mesurement\n\t\t -w RANGE, --warning RANGE\n\t\t warning if threshold is outside RANGE\n\t\t -c RANGE, --critical RANGE\n\t\t critical if threshold is outside RANGE\n\t\t -v, --verbose increase verbosity (use up to 3 times)\n\t\t -R REGION, --region REGION\n\t\t The AWS region to read metrics from\n\t\t -P profile_name, --profile profile_name\n Profile name from ~/.aws/credentials\n\nUsage\n=====\nCloudwatch metrics\n------------------\nFor information on how CloudWatch stores metrics check this `doc `_ out.\n\n- Simple EC2 CPU Utilization check, with warning and critical threshold ranges::\n\n\tcheck_cloudwatch.py -R us-west-2 -n AWS/EC2 -m CPUUtilization -p 600 -d InstanceId=i-abcd1234 -w 0:75 -c 0:90\n\tcheck_cloudwatch.py -R us-west-2 -n AWS/EC2 -m CPUUtilization -p 600 -d InstanceId=i-1bcd1234 -w 0:75 -c 0:90 -P dc-live\n\tcheck_cloudwatch.py -R us-west-2 -n AWS/EC2 -m CPUUtilization -p 600 -d InstanceId=i-2bcd1234 -w 0:75 -c 0:90 -P dc-staging\n\nReleases\n========\n0.2.7 - May 01, 2018: Added option to specify AWS credential profile. Thanks l13t!\n\n0.2.6 - Oct 23, 2014: Updated Readme example, fixed typoes. Thanks sampierson !\n\n0.2.5 - Sep 09, 2014: Support passing region as an argument, defaulting to boto default. Thanks grahamlyons!\n\n0.2.4 - Nov 20, 2013: Added support for delta monitoring of a single metric. Thanks nesQuick & s0enke!\n\n0.2.3 - Nov 20, 2013: Added support for monitoring ratio between two metrics. Thanks nesQuick & s0enke!\n\n\nDevelop\n=======\nFork me on `Github `_.", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/vimeo/nagios-cloudwatch-plugin", "keywords": "nagios cloudwatch plugin", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "nagios-cloudwatch-plugin", "package_url": "https://pypi.org/project/nagios-cloudwatch-plugin/", "platform": "", "project_url": "https://pypi.org/project/nagios-cloudwatch-plugin/", "project_urls": { "Homepage": "https://github.com/vimeo/nagios-cloudwatch-plugin" }, "release_url": "https://pypi.org/project/nagios-cloudwatch-plugin/0.2.7/", "requires_dist": null, "requires_python": "", "summary": "Nagios plugin to check AWS CloudWatch metrics", "version": "0.2.7" }, "last_serial": 3825674, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "e6aee57e3a34e5e76f18a9ba100bdcdd", "sha256": "dcd4ce2141ba7360bb9c8d80c1d7ae05be067cff9d5450aab1d8e9dd0077ae8e" }, "downloads": -1, "filename": "nagios-cloudwatch-plugin-0.1.tar.gz", "has_sig": false, "md5_digest": "e6aee57e3a34e5e76f18a9ba100bdcdd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1646, "upload_time": "2013-09-27T22:12:13", "url": "https://files.pythonhosted.org/packages/1d/c6/83b60cd3980e415a2b3864cb270d546e69221bdebdbf5cda33d83b5f67c3/nagios-cloudwatch-plugin-0.1.tar.gz" } ], "0.2": [ { "comment_text": "", "digests": { "md5": "44433a818bce4f66b46df6055410ec38", "sha256": "5e788d2362a3a9690ce3ff5a4a2907126a123cbe1f7e6a3721c6776677fd344a" }, "downloads": -1, "filename": "nagios-cloudwatch-plugin-0.2.tar.gz", "has_sig": false, "md5_digest": "44433a818bce4f66b46df6055410ec38", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2462, "upload_time": "2013-10-30T20:58:35", "url": "https://files.pythonhosted.org/packages/a2/67/6d2bb9fb547f5d96db24c67122c9274f832a2740d97740bb12885524df62/nagios-cloudwatch-plugin-0.2.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "7f497776a561ef3cd5b8f5092e47b36f", "sha256": "05284f1e4668028b3fc6661c62441d461f42cbea0bdcb722daf3d416dc20c844" }, "downloads": -1, "filename": "nagios-cloudwatch-plugin-0.2.1.tar.gz", "has_sig": false, "md5_digest": "7f497776a561ef3cd5b8f5092e47b36f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2465, "upload_time": "2013-10-30T21:05:06", "url": "https://files.pythonhosted.org/packages/32/9a/7285ae1c4aef5d99dd4c8134ff23f998e17cad6d529168f811b1a92bad7a/nagios-cloudwatch-plugin-0.2.1.tar.gz" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "7ee36cec64b312dc293f2ebb6633c964", "sha256": "85d2be16cdf2fc3a8a9ce94d9557660ba28dc3eeedf0abcaff38af738472cb84" }, "downloads": -1, "filename": "nagios-cloudwatch-plugin-0.2.2.tar.gz", "has_sig": false, "md5_digest": "7ee36cec64b312dc293f2ebb6633c964", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2545, "upload_time": "2013-11-08T18:38:38", "url": "https://files.pythonhosted.org/packages/b1/1b/ccd583b885257ad46fb986eb7093056d4a6a90cf6c8c341f4c72cb5dd8ac/nagios-cloudwatch-plugin-0.2.2.tar.gz" } ], "0.2.3": [ { "comment_text": "", "digests": { "md5": "63703cf5bbf56baf5ec5665487590142", "sha256": "49ef2315802652d9fbb900adafd9c7becd382276ded24e27d19aca6d47f1af56" }, "downloads": -1, "filename": "nagios-cloudwatch-plugin-0.2.3.tar.gz", "has_sig": false, "md5_digest": "63703cf5bbf56baf5ec5665487590142", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3181, "upload_time": "2013-11-20T18:28:52", "url": "https://files.pythonhosted.org/packages/8c/a8/11c1281ee64d0d84dfa356fc37b13adbad7e09d67520275a2affab7b69fe/nagios-cloudwatch-plugin-0.2.3.tar.gz" } ], "0.2.4": [ { "comment_text": "", "digests": { "md5": "78ce4c25a58ed28895490b6133e7f761", "sha256": "a2fef3657c9cdb2d132cde59f24bbd2628ea5412130a3d22d8f41bcdf850220a" }, "downloads": -1, "filename": "nagios-cloudwatch-plugin-0.2.4.tar.gz", "has_sig": false, "md5_digest": "78ce4c25a58ed28895490b6133e7f761", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3559, "upload_time": "2013-11-20T19:34:30", "url": "https://files.pythonhosted.org/packages/61/d6/38c04d5b13ce5be3103f489a6f9e769b5681f5b284ffaa91919e8164b2cb/nagios-cloudwatch-plugin-0.2.4.tar.gz" } ], "0.2.5": [ { "comment_text": "", "digests": { "md5": "886238941aca254d9786c1555e85ba8b", "sha256": "b6f73530d9b2ebdd393ac74ce6e17d019413475c4119e0b8a50da5c22bc086a3" }, "downloads": -1, "filename": "nagios-cloudwatch-plugin-0.2.5.tar.gz", "has_sig": false, "md5_digest": "886238941aca254d9786c1555e85ba8b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3810, "upload_time": "2014-09-09T19:08:07", "url": "https://files.pythonhosted.org/packages/a9/86/1a07916bbcd139cd2c82bc17ecb5840921a82b4a5ae02257336fd5511a2d/nagios-cloudwatch-plugin-0.2.5.tar.gz" } ], "0.2.6": [ { "comment_text": "", "digests": { "md5": "44875385310e829ef93167839af30fdb", "sha256": "7fc800f72d14c5dacadfcf0d8ef9fdcc2379d8ded6cae58b7fc5cb5857f072ea" }, "downloads": -1, "filename": "nagios-cloudwatch-plugin-0.2.6.tar.gz", "has_sig": false, "md5_digest": "44875385310e829ef93167839af30fdb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4076, "upload_time": "2014-10-24T02:28:42", "url": "https://files.pythonhosted.org/packages/52/b8/4fec806d415470e0894569ec6738709d8d79fcc74d8836d6e5f151001733/nagios-cloudwatch-plugin-0.2.6.tar.gz" } ], "0.2.7": [ { "comment_text": "", "digests": { "md5": "27f9c67c52ec150c13151ef3be9b874d", "sha256": "a87a6b1f343c83687e982518a78b08901bf06cdaefb05cbd50447dd2f8e50a35" }, "downloads": -1, "filename": "nagios-cloudwatch-plugin-0.2.7.tar.gz", "has_sig": false, "md5_digest": "27f9c67c52ec150c13151ef3be9b874d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4229, "upload_time": "2018-05-02T03:33:40", "url": "https://files.pythonhosted.org/packages/ec/55/60660df40aa4b1e29b0de5434758fc95c19e53db08599f22f103912a504a/nagios-cloudwatch-plugin-0.2.7.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "27f9c67c52ec150c13151ef3be9b874d", "sha256": "a87a6b1f343c83687e982518a78b08901bf06cdaefb05cbd50447dd2f8e50a35" }, "downloads": -1, "filename": "nagios-cloudwatch-plugin-0.2.7.tar.gz", "has_sig": false, "md5_digest": "27f9c67c52ec150c13151ef3be9b874d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4229, "upload_time": "2018-05-02T03:33:40", "url": "https://files.pythonhosted.org/packages/ec/55/60660df40aa4b1e29b0de5434758fc95c19e53db08599f22f103912a504a/nagios-cloudwatch-plugin-0.2.7.tar.gz" } ] }