zabbix-cloudwatch 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+--- 
+SHA512: 
+  metadata.gz: 1f1af98510d9a03961e30e98ca5f7f74a4d94dc5f86d7a987735d7d307b0584763f175dcfdc64a9e663e6303f1027c49fa19befd9d09984b38932d718e8c2dd0
+  data.tar.gz: 20c109761c48187c3d90a7eb831cea90542381c6528256ebb16fd5d5e9496d3fd8e5b96e00cd4f28bde249e22d1d5b080766fd711d55e0aea83e5852fabf0d88
+SHA1: 
+  metadata.gz: bc4b6e0406f4614781ee2dddc679d7387a30b2fe
+  data.tar.gz: 6d29fa50fe3a095e30cc1435c8348131c0dc41dc

data/.gitignore

@@ -0,0 +1 @@
+*.gem

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,24 @@
+PATH
+  remote: .
+  specs:
+    zabbix-cloudwatch (0.0.1)
+      aws-sdk (~> 1.21.0)
+      getopt (~> 1.4.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    aws-sdk (1.21.0)
+      json (~> 1.4)
+      nokogiri (>= 1.4.4, < 1.6.0)
+      uuidtools (~> 2.1)
+    getopt (1.4.1)
+    json (1.8.0)
+    nokogiri (1.5.10)
+    uuidtools (2.1.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  zabbix-cloudwatch!

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2013 Randy D. Wallace Jr.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,74 @@
+# zabbix-cloudwatch
+
+
+An external script for getting cloudwatch metrics into Zabbix
+
+```
+Usage: get_aws_cloudwatch_metric.rb
+
+  -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
+```
+
+## Getting it running
+
+* It is only guaranteed to work on ruby 1.8.7 at this time. 
+* 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
+```
+
+## 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
+```
+
+## 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"
+```
+
+## Notes
+
+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.
+
+The default behavior is to use the Environment variables *only* if the variables in the script are not set.
+
+### Setting the Environment variables
+```
+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=''
+```
+

data/bin/zabbix-cloudwatch

@@ -0,0 +1,66 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'bundler/setup'
+require 'getopt/long'
+require 'zabbix-cloudwatch'
+
+@@aws_access_key=''
+@@aws_secret_key=''
+@@aws_region=''
+
+
+class RubyVersionException < StandardError; end
+
+raise RubyVersionException, "Ruby version must be 1.8.7" unless RUBY_VERSION == "1.8.7"
+
+opts = Getopt::Long.getopts(
+   ["--help"],
+   ["--namespace",  Getopt::REQUIRED],
+   ["--metricname", Getopt::REQUIRED],
+   ["--dimension-name",  Getopt::REQUIRED],
+   ["--dimension-value","-v",  Getopt::REQUIRED],
+   ["--monitoring-type", "-t", Getopt::REQUIRED],
+   ["--statistic",Getopt::REQUIRED],
+   ["--aws-access-key", Getopt::REQUIRED],
+   ["--aws-secret-key", Getopt::REQUIRED],
+   ["--aws-region", Getopt::REQUIRED]
+)
+
+
+def usage
+  puts <<EOF
+Usage: #{$0}
+
+  -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
+
+EOF
+  exit 1
+end
+
+if opts.key?"help" or opts.empty?
+  usage
+  exit 0
+end
+
+unless opts.key?"aws-access-key"
+  opts["aws-access-key"] = (@@aws_access_key == '' && ENV["AWS_ACCESS_KEY_ID"])     || @@aws_access_key
+end
+unless opts.key?"aws-secret-key"
+  opts["aws-secret-key"] = (@@aws_secret_key == '' && ENV["AWS_SECRET_ACCESS_KEY"]) || @@aws_secret_key
+end
+unless opts.key?"aws-region"
+  opts["aws-region"] = (@@aws_region     == '' && ENV["AWS_REGION"])            || @@aws_region
+end
+
+inst = ZabbixCloudwatch::GetCloudwatchMetric.new(opts)
+inst.run!

data/lib/zabbix-cloudwatch.rb

@@ -0,0 +1,121 @@
+require 'zabbix-cloudwatch/version'
+require 'aws-sdk'
+
+module ZabbixCloudwatch
+  class GetCloudwatchMetric
+    class NamespaceArgumentMissingException < StandardError; end
+    class MetricnameArgumentMissingException < StandardError; end
+    class DimensionArgumentMissingException < StandardError; end
+    class MonitoringTypeArgumentException < StandardError; end
+    class StatisticTypeArgumentException < StandardError; end
+    class AwsAccessKeyMissingException < StandardError; end
+    class AwsSecretKeyMissingException < StandardError; end
+    class BadAWSAccessKeysException < StandardError; end
+  
+    attr_accessor :options, :aws, :start_time, :end_time, :period, :statistic
+  
+    def initialize options
+      self.options = options
+      usage if options.key?"help"
+      raise NamespaceArgumentMissingException unless options.key?"namespace"
+      raise MetricnameArgumentMissingException unless options.key?"metricname"
+      raise DimensionArgumentMissingException unless options.key?"dimension-name"
+      raise DimensionArgumentMissingException unless options.key?"dimension-value"
+      self.aws = AWS::CloudWatch.new(get_aws_options).client
+      test_aws_connectivity
+      set_time_range
+      set_statistic
+    end
+
+    def get_aws_options
+      raise AwsAccessKeyMissingException unless options.key?"aws-access-key"
+      raise AwsSecretKeyMissingException unless options.key?"aws-secret-key"
+      if options.key?"aws-region" && options['aws-region'] != ''
+        region = options["aws-region"]
+      else
+        region = 'us-east-1'
+      end
+      puts options.inspect
+      {:access_key_id => options["aws-access-key"], :secret_access_key => options["aws-secret-key"], :region => region}
+    end
+  
+    def set_statistic
+      unless options.key?"statistic"
+        self.statistic = "Average"
+      else
+        if options["statistic"] =~ /Minimum|Maximum|Average|Sum|SampleCount/
+          self.statistic = options["statistic"]
+        else
+          raise StatisticTypeArgumentException, "Statistic type must be one of: Minimum, Maximum, Average, Sum, SampleCount. "
+        end
+      end
+    end
+  
+    def set_time_range
+      unless options.key?"monitoring-type"
+        detailed = false
+      else
+        if options["monitoring-type"] =~ /detailed|basic/
+          detailed = true if options["monitoring-type"] == 'detailed'
+          detailed = false if options["monitoring-type"] == 'basic'
+        else
+          raise MonitoringTypeArgumentException, "Monitoring type must be either 'detailed' or 'basic'. "
+        end
+      end
+      if detailed
+        self.start_time = time_one_minute_ago
+        self.period = 60
+      else
+        self.start_time = time_five_minutes_ago
+        self.period = 360
+      end
+      self.end_time = time_now
+    end
+  
+    def time_now
+      Time.now.utc.iso8601
+    end
+  
+    def time_one_minute_ago
+      # Not really 1 minute ago, but adds a bit of buffer for amazon's silliness 
+      (Time.now - 90).utc.iso8601
+    end
+  
+    def time_five_minutes_ago
+      # Not really 5 minutes ago, but adds a bit of buffer for amazon's silliness 
+      (Time.now - (60*7+30)).utc.iso8601
+    end
+  
+    def run!
+      ret = aws.get_metric_statistics({
+              :namespace => options["namespace"],
+              :metric_name => options["metricname"],
+              :dimensions => [{:name => options["dimension-name"],:value => options["dimension-value"]}],
+              :period => period,
+              :start_time => start_time,
+              :end_time => end_time,
+              :statistics => [statistic]})
+      begin
+        symbol = statistic.downcase.to_sym
+        symbol = :sample_count if symbol == :samplecount
+        puts ret[:datapoints][0][symbol]
+      rescue
+        exit 1
+      end
+    end
+  
+    def test_aws_connectivity
+      begin
+        aws.describe_alarms(:max_records => 1)
+      rescue
+        raise BadAWSAccessKeysException, <<-EOF
+  
+  You cannot access AWS due to one of the following reasons:
+    - The AWS keys provided do not have access to Cloudwatch
+    - your server is not synced with NTP
+    - The Region setting is missing or incorrect
+          EOF
+      end
+    end
+  end
+end

data/lib/zabbix-cloudwatch/version.rb

@@ -0,0 +1,4 @@
+
+module ZabbixCloudwatch
+  VERSION = "0.0.1"
+end

data/zabbix-cloudwatch.gemspec

@@ -0,0 +1,23 @@
+$:.push File.expand_path("../lib", __FILE__)
+
+require "zabbix-cloudwatch/version"
+
+Gem::Specification.new do |s|
+  s.name        = "zabbix-cloudwatch"
+  s.version     = ZabbixCloudwatch::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.license     = "MIT"
+  s.authors     = ["Randy D. Wallace Jr."]
+  s.email       = ["randy@randywallace.com"]
+  s.homepage    = "http://github.com/randywallace/zabbix-cloudwatch"
+  s.summary     = %q{A library for getting cloudwatch metrics into Zabbix}
+  s.description = %q{A library for getting cloudwatch metrics into Zabbix\nPlease see http://github.com/randywallace/zabbix-cloudwatch for more details}
+
+  s.add_runtime_dependency "aws-sdk", "~> 1.21.0"
+  s.add_runtime_dependency "getopt", "~> 1.4.1"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification 
+name: zabbix-cloudwatch
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Randy D. Wallace Jr.
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2013-10-26 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: aws-sdk
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.21.0
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: getopt
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.4.1
+  type: :runtime
+  version_requirements: *id002
+description: A library for getting cloudwatch metrics into Zabbix\nPlease see http://github.com/randywallace/zabbix-cloudwatch for more details
+email: 
+- randy@randywallace.com
+executables: 
+- zabbix-cloudwatch
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- bin/zabbix-cloudwatch
+- lib/zabbix-cloudwatch.rb
+- lib/zabbix-cloudwatch/version.rb
+- zabbix-cloudwatch.gemspec
+homepage: http://github.com/randywallace/zabbix-cloudwatch
+licenses: 
+- MIT
+metadata: {}
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - &id003 
+    - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - *id003
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 2.0.12
+signing_key: 
+specification_version: 4
+summary: A library for getting cloudwatch metrics into Zabbix
+test_files: []
+