zabbix-cloudwatch 0.0.3 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 --- 
 SHA1: 
-  data.tar.gz: e5e54a22a40a53783759bf0d706844624b06e12e
-  metadata.gz: 94712ee0291e1e070547bd4cc13e29d6292c481d
+  metadata.gz: 20e69415398bb85c6d7d8541c92b271de26b64d3
+  data.tar.gz: 94a08809d18903fe2d358e1601761dd75957ee96
 SHA512: 
-  data.tar.gz: fef695c594152393744977565a2214ce2826952c70d5f8d178ecac56eb6b3353b0ed61f9e7cd01ae63fe8a29ae3c2c134e593c42e8d23427a9c12fcd1280ce96
-  metadata.gz: 96db89212bc7a28f33b8b98f45196369e76bc365f5a7a1f6ed523949149f3d0301ede8ddba8cfea8601e9674791fd72874f3c5e0bfd20f792ebc8ac32bb3d960
+  metadata.gz: 11784a6df6ded7584105843bdadd452cf48c4b78cda4775e6ca2041c918fec769702801dac08132da44a3615b101f48bacc7857e21200810a82803df9b6198fa
+  data.tar.gz: 298df00a3a466cdb900220e31a3db8a82f93d50feb5fabf6f2eac08809867b110470fae2f26cb0ee880aba0293b54920d2adc2d169a749363adcedc3c91bfea2

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    zabbix-cloudwatch (0.0.2)
+    zabbix-cloudwatch (0.0.3)
       aws-sdk (~> 1.21.0)
       getopt (~> 1.4.1)
 

data/README.md

@@ -4,7 +4,7 @@
 An external script for getting cloudwatch metrics into Zabbix
 
 ```
-Usage: get_aws_cloudwatch_metric.rb
+Usage: zabbix-cloudwatch
 
   -h, --help              This Message
   -n, --namespace         Namespace (AWS/Autoscaling, AWS/EC2, etc...)
@@ -13,33 +13,32 @@ Usage: get_aws_cloudwatch_metric.rb
   -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. 
+* 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):
 ```
-# git clone git@github.com:randywallace/zabbix-cloudwatch.git /usr/local/zabbix-cloudwatch
-# cd /usr/local/zabbix-cloudwatch
-# chown zabbix:zabbix get_aws_cloudwatch_metric.rb
 # yum install ruby ruby-devel rubygems gcc libxml2-devel libxslt-devel
-# gem install bundler
-# bundle install
-# ln -s /usr/local/zabbix-cloudwatch/get_aws_cloudwatch_metric.rb /var/lib/zabbixsrv/externalscripts/get_aws_cloudwatch_metric.rb
+# gem install bundler zabbix-cloudwatch
+# ln -s $(which zabbix-cloudwatch) /var/lib/zabbixsrv/externalscripts/zabbix-cloudwatch
 ```
 
 ## Examples
 
 ```
-/usr/local/zabbix-cloudwatch/get_aws_cloudwatch_metric.rb -n AWS/EC2 \
-                                                          -m CPUUtilization \
-                                                          -d AutoScalingGroupName \
-                                                          -v your-auto-scaling-group \
-                                                          -t detailed \
-                                                          -s Sum
+zabbix-cloudwatch -n AWS/EC2 \
+                  -m CPUUtilization \
+                  -d AutoScalingGroupName \
+                  -v your-auto-scaling-group \
+                  -t detailed \
+                  -s Sum
 ```
 
 ## Creating the IAM User
@@ -51,24 +50,32 @@ The following actions need to be allowed in IAM for this script to work with the
 "cloudwatch:GetMetricStatistics"
 ```
 
-## Notes
+## AWS Credentials
 
-The class variables within get_aws_cloudwatch_metric.rb should be set if you do not (or don't want to) set environment
-variables for your AWS Credentials.
+There are (3) ways to get your AWS Credentials into `zabbix-cloudwatch`.
 
-The default behavior is to use the Environment variables *only* if the variables in the script are not set.
+**Note that *none* of these options are "safe", so make sure you are using a set of IAM Keys with extremely restricted 
+permissions.**
 
-### Setting the Environment variables
+### 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"
 ```
 
-### Class variables at the top of get_aws_cloudwatch_metric.rb
-```
-@@aws_access_key=''
-@@aws_secret_key=''
-@@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
 

data/lib/zabbix-cloudwatch/version.rb

@@ -1,4 +1,4 @@
 
 module ZabbixCloudwatch
-  VERSION = "0.0.3"
+  VERSION = "0.0.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: zabbix-cloudwatch
 version: !ruby/object:Gem::Version 
-  version: 0.0.3
+  version: 0.0.4
 platform: ruby
 authors: 
 - Randy D. Wallace Jr.