AWS Cloudwatch automated ELB/RDS/EC2 graphing
PHP JavaScript
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
AWS-sdk
css
imgs
jquery
js
LICENSE
README.md
chart_colours.php
ec2_data.php
ec2_graphs.php
elb_data.php
elb_graphs.php
graph.php
index.php
nav.php
rds_data.php
rds_graphs.php
updatedmindata.php

README.md

CloudWatchr

AWS Cloudwatch automated ELB/RDS/EC2 graphing

Using

Builds upon but is substantially changed from https://github.com/manuskc/aws-cloudchart

Plots all the Cloudwatch metrics for your ELB, EC2 and RDS instances using only a set of read-only IAM credentials

alt tag

About

I got frustrated with the amount of clickery required to get a decent graph out of Amazons Cloudwatch Service and seeing there were no simple, free solutions for RDS monitoring at all, I filled the niche.

This uses the outdated but still functional AWS PHP-SDK v1.62 to enumerate, and then gather Cloudwatch data for the last 6 hours for, any ELB, EC2 and RDS instances running in the account to which your IAM credentials give access.

The code is pre-configured for all the major (and some minor) Cloudwatch metrics for each instance type.

It also has two cool features:

  • Clicking an entry in the legend will hide that data series on that graph and all below it. Clicking it again with unhide.
  • Data series are automatically coloured. Makes reading the graphs a bit more pleasant.

The code should be pretty easy to read and add to. Please feel free to contribute and/or fork.

Released under the MIT licence.

How to use

Requires:

  • Nginx, Apache or similar web server
  • A set of Amazon IAM credentials (use the Read-only Access policy template provided by AWS)

Clone the repo/Upload to a web accessible folder on your server.

Edit AWS-sdk/config.inc.php to include your own IAM key and secret.

Done! Your graphs should now be viewable.

Options

The graph pages will take three URL parameters:

  • period: in seconds between data points. default: 300s (5 min)
  • fromtime: date/time graphs should start - in an format strtotime (http://uk1.php.net/strtotime) can convert. default: 6 hours ago
  • endtime: date/time graph should end - again strtotime format. default: now.

e.g. http://www.thisismygraphserver.com/ec2_graphs.php?period=3600&fromtime=last%20tuesday&endtime=yesterday

Gotchas:

  • You may also need to grep for REGION_EU_W1 and change it to your applicable AWS region namespace. See here: http://docs.aws.amazon.com/AWSSDKforPHP/latest/index.html#m=AmazonEC2/set_region
  • I use the AWS Name tag to identify my EC2 instances. This may not be the case for you. Have a look at ec2_data.php around line 44 to modify.
  • My name tags also have hyphens in them, which javascript doesn't like in vars. Hence in ec2_data.php, line 31, you may want to change the str_replace to something else.

Other Notes

There are many ways you can also add your own custom metrics into Cloudwatch and CWGraphs should be able to pull any of them. As an example, I have included in the ec2_graphs code a custom metric graph for EC2 memory usage (line 73 et al). This requires a python script (https://gist.github.com/PercussiveRepair/9781858 forked from https://gist.github.com/shevron/6204349) cronned to run on your EC2 instances to post the data back to Cloudwatch which CWGraphs can retrieve and display.

PS. Apologies for my code. I'm a sysadmin, not a programmer :)