skip to navigation
skip to content

nagios-cloudwatch-plugin 0.2.4

Nagios plugin to check AWS CloudWatch metrics

Latest Version: 0.2.6

This plugin for checks AWS CloudWatch metrics. It uses the popular boto library to gather metric values. This plugin does not currently have a means of directly supplying AWS credentials - for this, consult the boto docs.


  1. pip install nagios-cloudwatch-plugin

  2. /usr/local/bin/ -h:

    usage: [-h] -n NAMESPACE -m METRIC [-d DIMENSIONS]
                               [-s {Average,Sum,SampleCount,Maximum,Minimum}]
                               [-p PERIOD] [-l LAG] [-r]
                               [--divisor-namespace DIVISOR_NAMESPACE]
                               [--divisor-metric DIVISOR_METRIC]
                               [--divisor-dimensions DIVISOR_DIMENSIONS]
                               [--divisor-statistic {Average,Sum,SampleCount,Maximum,Minimum}]
                               [--delta DELTA] [-w RANGE] [-c RANGE] [-v]
    Nagios plugin to check cloudwatch metrics
    optional arguments:
      -h, --help            show this help message and exit
      -n NAMESPACE, --namespace NAMESPACE
                            namespace for cloudwatch metric
      -m METRIC, --metric METRIC
                            metric name
      -d DIMENSIONS, --dimensions DIMENSIONS
                            dimensions of cloudwatch metric in the format
      -s {Average,Sum,SampleCount,Maximum,Minimum}, --statistic {Average,Sum,SampleCount,Maximum,Minimum}
                            statistic used to evaluate metric
      -p PERIOD, --period PERIOD
                            the period in seconds over which the statistic is
      -l LAG, --lag LAG     delay in seconds to add to starting time for gathering
                            metric. useful for ec2 basic monitoring which
                            aggregates over 5min periods
      -r, --ratio           this activates ratio mode
      --divisor-namespace DIVISOR_NAMESPACE
                            ratio mode: namespace for cloudwatch metric of the
      --divisor-metric DIVISOR_METRIC
                            ratio mode: metric name of the divisor
      --divisor-dimensions DIVISOR_DIMENSIONS
                            ratio mode: dimensions of cloudwatch metric of the
      --divisor-statistic {Average,Sum,SampleCount,Maximum,Minimum}
                            ratio mode: statistic used to evaluate metric of the
      --delta DELTA         time in seconds to build a delta mesurement
      -w RANGE, --warning RANGE
                            warning if threshold is outside RANGE
      -c RANGE, --critical RANGE
                            critical if threshold is outside RANGE
      -v, --verbose         increase verbosity (use up to 3 times)


0.2.4 - Nov 20, 2013: Added support for delta monitoring of a single metric. Thanks nesQuick & s0enke! 0.2.3 - Nov 20, 2013: Added support for monitoring ratio between two metrics. Thanks nesQuick & s0enke!


Fork me on Github.

File Type Py Version Uploaded on Size
nagios-cloudwatch-plugin-0.2.4.tar.gz (md5) Source 2013-11-20 3KB