Skip to main content

Nagios plugin to check AWS CloudWatch metrics

Project description

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.

Setup

  1. pip install nagios-cloudwatch-plugin

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

    usage: check_cloudwatch.py [-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
                            dimension=value[,dimension=value...]
      -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
                            applied
      -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
      --divisor-metric DIVISOR_METRIC
                            ratio mode: metric name of the divisor
      --divisor-dimensions DIVISOR_DIMENSIONS
                            ratio mode: dimensions of cloudwatch metric of the
                            divisor
      --divisor-statistic {Average,Sum,SampleCount,Maximum,Minimum}
                            ratio mode: statistic used to evaluate metric of the
                            divisor
      --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)
    

Releases

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!

Develop

Fork me on Github.

Project details


Release history Release notifications

History Node

0.2.7

History Node

0.2.6

History Node

0.2.5

This version
History Node

0.2.4

History Node

0.2.3

History Node

0.2.2

History Node

0.2.1

History Node

0.2

History Node

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
nagios-cloudwatch-plugin-0.2.4.tar.gz (3.6 kB) Copy SHA256 hash SHA256 Source None Nov 20, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page