5.12. cloudwatch

The Cloudwatch module gathers metrics via the AWS Cloudwatch API

loader

lua

object

noit.module.cloudwatch

5.12.1. Module Configuration

5.12.2. Check Configuration

url
required

required

default

https://monitoring.amazonaws.com

allowed

.+

The URL including schema and hostname for the Cloudwatch monitoring server.

api_key
required

required

allowed

.+

The AWS API Key

api_secret
required

required

allowed

.+

The AWS API Secret

namespace
required

required

allowed

.+

The namespace to pull parameters from

cloudwatch_metrics
required

required

allowed

.+

A comma-delimited list of metrics to pull data for

granularity
required

optional

default

5

allowed

1|5

The granularity of cloudwatch data to pull - one or five minutes

statistics
required

optional

default

Average

allowed

.+

A comma-delimited list of statistics to pull per metric (Choices are: Average, Sum, SampleCount, Maximum, Minimum)

version
required

optional

default

2010-08-01

allowed

.+

The version of the Cloudwatch API to use.

dim_.*
required

optional

allowed

.*

The dimensions to query for each metric. dim_foo will set a metric with dimension "foo".

Example 5.13. Check Cloudwatch data

This example checks some Cloudwatch data

      <noit>
        <modules>
          <loader image="lua" name="lua">
            <config><directory>/opt/reconnoiter/libexec/modules-lua/?.lua</directory></config>
          </loader>
          <module loader="lua" name="cloudwatch" object="noit.module.cloudwatch"/>
        </modules>
        <checks>
          <check uuid="2d42adbc-7c7a-11dd-a48f-4f59e0b654d3" module="cloudwatch" period="300000" target="176.32.99.241">
            <api_key>this_is_a_dummy_key</api_key>
            <api_secret>this_is_a_dummy_secret</api_secret>
            <namespace>AWS/EC2</namespace>
            <cloudwatch_metrics>CPUUtilization</cloudwatch_metrics>
            <statistics>Average,Sum</statistics>
            <dim_InstanceId>dummyInstance</dim_InstanceId>
          </check>
        </checks>
      </noit>