public
Description: Plugins for the Scout Server Monitoring and Reporting Tool
Homepage: http://scoutapp.com/
Clone URL: git://github.com/highgroove/scout-plugins.git
Andre Lewis (author)
Fri Oct 30 17:58:36 -0700 2009
commit  d11da55e080ec937fed5c1a205178cf969da4969
tree    9da8fd417687a47cdbabd81e1dfccafc0b5d17ef
parent  c7815c2bf7d096353e4ef9fee7ad30eba85b9029
scout-plugins / ec2_cloudwatch
name age message
..
file README Mon Aug 17 17:41:48 -0700 2009 re-added readme [Andre Lewis]
file ec2_cloudwatch.rb Mon Aug 17 15:50:41 -0700 2009 support querying across autoscaling group, etc.... [Andre Lewis]
file ec2_cloudwatch.yml Mon Aug 17 15:52:41 -0700 2009 fixed metadata [Andre Lewis]
ec2_cloudwatch/README
EC2 CloudWatch plugin
=====================
Created by Andre Lewis

This plugin uses AWS web service calls to fetch the following CloudWatch metrics for your EC2 instances:

  NetworkIn NetworkOut DiskReadOps DiskWriteOps DiskReadBytes DiskWriteBytes CPUUtilization

Using this plugin, you can graph CloudWatch data, create alerts on CloudWatch, track trends  on CloudWatch, etc.
Your Cloudwatch data will appear alongside all the other data collected by the Scout agent.

Note, this plugin does not fetch EC2 Load Balancer Metrics. This plugin is in beta, and we appreciate you feedback
at support@scoutapp.com.


Fetching metrics for one instance
----------------------------------

By default, the value you put in the "EC2 InstanceId or dimension" plugin option is treated as an EC2 InstanceId.
EC2 InstanceIds currently look like this: i-48ac4920. Providing an InstanceID will fetch metrics for that instance 
alone.

Providing the InstanceID is the easiest way to get started. You can get your InstanceID from the AWS web console
(https://console.aws.amazon.com/ec2/home), or through the command line tools



Autoscaling groups, etc
----------------------------------

Alterntively, you can fetch metrics by autoscaling group name, image id, or instance type. You will still get one set
of numbers, but the numbers will be averaged from all the instances in the dimension you specifiy.

To fetch Cloudwatch data across a different dimension, enter a key=value string in the "EC2 InstanceId or dimension".
You can use:
  
  AutoScalingGroupName=YOUR_AUTOSCALING_GROUP_NAME
  ImageId=YOUR_IMAGE_ID
  InstanceType=YOUR_INSTANCE_TYPE
  InstanceId=YOUR_IMAGE_ID (this is the same as providing the ImageId alone)