zabbix-cloudwatch
An external script for getting cloudwatch metrics into Zabbix
``` Usage: zabbix-cloudwatch
-h, –help This Message -n, –namespace Namespace (AWS/Autoscaling, AWS/EC2, etc…) -m, –metricname Metric Name (GroupInServiceInstances,EstimatedCharges, etc…) -d, –dimension-name Dimension Name (AutoScalingGroupName, etc…) -v, –dimension-value Dimension Value -t, –monitoring-type detailed|basic Default: basic -s, –statistic Minimum|Maximum|Average|Sum|SampleCount Default: Average –aws-access-key AWS Access Key –aws-secret-key AWS Secret Key –aws-region AWS Region (us-east-1) Default: us-east-1 ```
Getting it running
- It is only guaranteed to work on ruby 1.8.7 at this time and will throw an Exception on other rubies.
- for some of the gem dependencies, you will need the ruby development packages, gcc, libxml2, and libxslt
Modify these steps to taste (examples given running on the Amazon AMI 2013.03):
# yum install ruby ruby-devel rubygems gcc libxml2-devel libxslt-devel
# gem install bundler zabbix-cloudwatch
# ln -s $(which zabbix-cloudwatch) /var/lib/zabbixsrv/externalscripts/zabbix-cloudwatch
Examples
zabbix-cloudwatch -n AWS/EC2 \
-m CPUUtilization \
-d AutoScalingGroupName \
-v your-auto-scaling-group \
-t detailed \
-s Sum
Creating the IAM User
The following actions need to be allowed in IAM for this script to work with the keys you provide:
"cloudwatch:DescribeAlarms"
"cloudwatch:GetMetricStatistics"
AWS Credentials
There are (3) ways to get your AWS Credentials into zabbix-cloudwatch.
Note that none of these options are “safe”, so make sure you are using a set of IAM Keys with extremely restricted permissions.
1. Environment Variables (which is difficult with Zabbix):
export AWS_ACCESS_KEY_ID="YOUR ACCESS KEY"
export AWS_SECRET_ACCESS_KEY="YOUR SECRET ACCESS KEY"
export AWS_REGION="YOUR AWS REGION"
2. Within the binary in the gem.
Find it with which zabbix-cloudwatch. If you intend to do it this way, I suggest you make a copy of the binary
and place it in your zabbix externalscript path (instead of the suggested symlink in the installation example).
The class variables for this are at the very top of the file for your convenience.
3. Passing in your AWS Keys when you run zabbix-cloudwatch using the command line flags.
The order of preference that this gem uses for the region and keys (individually) are:
- Commandline flag
- Within the binary
- Environment Variable