cloudwatch_monitoring

Bash script that reports custom metric data about Linux performance to Amazon CloudWatch

This bash script will work on:

• Amazon Linux 2014.3
• Red Hat Enterprise Linux 6.4
• Ubuntu Server 13.10

although the puppet script needs a little bit of work.

The script is written in simple Bash, so you can use it very easily and it use the aws-cli. The script is from https://github.com/moomindani/aws-mon-linux. The script is almost compatible with Amazon CloudWatch Monitoring Scripts for Linux, so you can use almost same options.

The script also supports running instance behind an http proxy!!!

Minimual Usage

  class { 'cloudwatch_monitoring': }

Detailed Usage

  class { 'cloudwatch_monitoring':
     username         => 'cw_monitoring',
     group            => 'cw_monitoring',
     home_dir         => '/home/cw_monitoring',
     aws_access_key   => 'MYAWSACCESSKEYID',
     aws_secret_key   => 'MYAWSSECRETACESSKEY',
     http_proxy       => undef,
     cron_description => 'cloudwatch_monitoring',
     options          => '--disk-space-util --disk-path=/ --disk-space-used  --disk-space-avail --swap-util --swap-used  --mem-util --mem-used --mem-avail',
     cron_minute      => '*/5',
  }

AWS authentication

with IAM role (recommended)

If your instance has an IAM role, then the script will use it to and you don't have to worry about setting keys.

Make sure that the role has permissions to perform the Amazon CloudWatch PutMetricData operation.

with a key

If your instance does not have a role, you need to specify the aws_access_key and aws_secret_key. It recommended that you store these encrypted in your puppet repository in hiera using eyaml to encrypt them.

Metrics of This Script

This script can report the following metrics:

• load average
• interrupt
• context switch
• cpu (user/system/idle/wait/steal)
• memory
• swap
• disk

Using the Script

This script collects load average, cpu, memory, swap, and disk space utilization data on the current system. It then makes a remote call to Amazon CloudWatch to report the collected data as custom metrics.

Options

TO DO

Support Multiple disk paths.

Support ubuntu would be very easy.