sensu-plugins-aws 0.0.1.alpha.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: dab7adef4e04f7bc487ae96de657558e16cd94e5
+  data.tar.gz: d80911aa488f0ff85b48d4a4be995824af92b262
+SHA512:
+  metadata.gz: 4ee5d2b5f5a54f359f868030fea933111d3cb403e85ace06719259893c658e6d7c973b3bef29e9d75b98df4566d99a627ad873bb994420d14f89d00e88853cc9
+  data.tar.gz: 802d9264b64bc401da0606273e34c15423ef56b9d81c18f28283be11d489c0cdbbf9f9bda77f4f61916dd8ef10ea5ac505f3f299ce4586937095ddac4a688905

checksums.yaml.gz.sig

@@ -0,0 +1,2 @@
+�f�y��?�E֜�Fݗ���8Dqz6�~,E�L��iv��诽hR�OЁ��I�y����P�1�H3��^%Y��j���y�SKv�eT9�ܮ
�-H�5���^O_խ9TpMp�T�!~N����F����� �z�s�pY����,��.�%d��n�����l-��dF�q��Xhm3�|E�N=���W5�L!/ �uA���ޙ>�
+���:J��RR��o$1*��'�d�^���%?_�^�`�}r3

data/CHANGELOG.md

@@ -0,0 +1,15 @@
+#### 0.1.0.alpha.1
+
+* baseline release identical to **sensu-community-plugins** repo
+* removed check-vpc-vpn.py
+* built against 1.9.3, 2.0, 2.1
+* change the ec2_node.rb to ec2-node.rb
+
+#### 0.0.1.alpha.2
+
+* add pry as a development dependency
+* add new badge for dependencies
+* add irc integration
+* updated install instructions
+* added check-vpc-vpn.py (may be removed before first stable release)
+* pulled latest script version from community repo

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2015 devops@yieldbot.com
+
+MIT License
+
+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,125 @@
+## Sensu-Plugins-aws
+
+[![Build Status](https://travis-ci.org/sensu-plugins/sensu-plugins-aws.svg?branch=master)](https://travis-ci.org/sensu-plugins/sensu-plugins-aws)
+[![Gem Version](https://badge.fury.io/rb/sensu-plugins-aws.svg)](http://badge.fury.io/rb/sensu-plugins-aws)
+[![Code Climate](https://codeclimate.com/github/sensu-plugins/sensu-plugins-aws/badges/gpa.svg)](https://codeclimate.com/github/sensu-plugins/sensu-plugins-aws)
+[![Test Coverage](https://codeclimate.com/github/sensu-plugins/sensu-plugins-aws/badges/coverage.svg)](https://codeclimate.com/github/sensu-plugins/sensu-plugins-aws)
+[![Dependency Status](https://gemnasium.com/sensu-plugins/sensu-plugins-aws.svg)](https://gemnasium.com/sensu-plugins/sensu-plugins-aws)
+
+## Functionality
+
+**check_vpc_vpn**
+
+**autoscaling-instance-count-metrics.rb**
+
+**check-dynamodb-capacity.rb**
+
+**check-dynamodb-throttle.rb**
+
+**check-ec2-network.rb**
+
+**check-elb-certs.rb**
+
+**check-elb-health-fog.rb**
+
+**check-elb-health-sdk.rb**
+
+**check-elb-latency.rb**
+
+**check-elb-nodes.rb**
+
+**check-elb-sum-requests.rb**
+
+**check-instance-events.rb**
+
+**check-rds-events.rb**
+
+**check-rds.rb**
+
+**check-redshift-events.rb**
+
+**check-ses-limit.rb**
+
+**check-sqs-messages.rb**
+
+**ec2-count-metrics.rb**
+
+**ec2-node.rb**
+
+**elasticache-metrics.rb**
+
+**elb-full-metrics.rb**
+
+**elb-latency-metrics.rb**
+
+**elb-metrics.rb**
+
+**sqs-metrics.rb**
+
+## Files
+
+* /bin/check_vpc_vpn
+* /bin/autoscaling-instance-count-metrics.rb
+* /bin/check-dynamodb-capacity.rb
+* /bin/check-dynamodb-throttle.rb
+* /bin/check-ec2-network.rb
+* /bin/check-elb-certs.rb
+* /bin/check-elb-health-fog.rb
+* /bin/check-elb-health-sdk.rb
+* /bin/check-elb-latency.rb
+* /bin/check-elb-nodes.rb
+* /bin/check-elb-sum-requests.rb
+* /bin/check-instance-events.rb
+* /bin/check-rds-events.rb
+* /bin/check-rds.rb
+* /bin/check-redshift-events.rb
+* /bin/check-ses-limit.rb
+* /bin/check-sqs-messages.rb
+* /bin/ec2-count-metrics.rb
+* /bin/ec2-node.rb
+* /bin/elasticache-metrics.rb
+* /bin/elb-full-metrics.rb
+* /bin/elb-latency-metrics.rb
+* /bin/elb-metrics.rb
+* /bin/sqs-metrics.rb
+
+## Usage
+
+## Installation
+
+Add the public key (if you haven’t already) as a trusted certificate
+
+```
+gem cert --add <(curl -Ls https://raw.githubusercontent.com/sensu-plugins/sensu-plugins.github.io/master/certs/sensu-plugins.pem)
+gem install <gem> -P MediumSecurity
+```
+
+You can also download the key from /certs/ within each repository.
+
+#### Rubygems
+
+`gem install sensu-plugins-aws`
+
+#### Bundler
+
+Add *sensu-plugins-aws* to your Gemfile and run `bundle install` or `bundle update`
+
+#### Chef
+
+Using the Sensu **sensu_gem** LWRP
+```
+sensu_gem 'sensu-plugins-aws' do
+  options('--prerelease')
+  version '0.0.1.alpha.2'
+end
+```
+
+Using the Chef **gem_package** resource
+```
+gem_package 'sensu-plugins-process-checks' do
+  options('--prerelease')
+  version '0.0.1.alpha.2'
+end
+```
+
+## Notes

data/bin/autoscaling-instance-count-metrics.rb

@@ -0,0 +1,87 @@
+#! /usr/bin/env ruby
+#
+# autoscaling-instance-count-metrics
+#
+# DESCRIPTION:
+#   Get a count of instances in a given AutoScaling group
+#
+# OUTPUT:
+#   metric-data
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: aws-sdk
+#   gem: sensu-plugin
+#
+# USAGE:
+#
+# NOTES:
+#
+# LICENSE:
+#   Copyright 2013 Bashton Ltd http://www.bashton.com/
+#   Released under the same terms as Sensu (the MIT license); see LICENSE
+#   for details.
+#
+
+require 'rubygems' if RUBY_VERSION < '1.9.0'
+require 'sensu-plugin/metric/cli'
+require 'aws-sdk'
+
+class AutoScalingInstanceCountMetrics < Sensu::Plugin::Metric::CLI::Graphite
+  option :groupname,
+         description: 'Name of the AutoScaling group',
+         short: '-g GROUP_NAME',
+         long: '--autoscaling-group GROUP_NAME',
+         required: true
+
+  option :scheme,
+         description: 'Metric naming scheme, text to prepend to metric',
+         short: '-s SCHEME',
+         long: '--scheme SCHEME',
+         default: ''
+
+  option :aws_access_key,
+         short: '-a AWS_ACCESS_KEY',
+         long: '--aws-access-key AWS_ACCESS_KEY',
+         description: "AWS Access Key. Either set ENV['AWS_ACCESS_KEY_ID'] or provide it as an option",
+         default: ENV['AWS_ACCESS_KEY']
+
+  option :aws_secret_access_key,
+         short: '-k AWS_SECRET_ACCESS_KEY',
+         long: '--aws-secret-access-key AWS_SECRET_ACCESS_KEY',
+         description: "AWS Secret Access Key. Either set ENV['AWS_SECRET_ACCESS_KEY'] or provide it as an option",
+         default: ENV['AWS_SECRET_KEY']
+
+  option :aws_region,
+         short: '-r AWS_REGION',
+         long: '--aws-region REGION',
+         description: 'AWS Region (such as eu-west-1).',
+         default: 'us-east-1'
+
+  def aws_config
+    hash = {}
+    hash.update aws_access_key_id: config[:aws_access_key], aws_secret_access_key: config[:aws_secret_access_key]\
+      if config[:aws_access_key] && config[:aws_secret_access_key]
+    hash.update region: config[:aws_region]
+    hash
+  end
+
+  def run
+    if config[:scheme] == ''
+      graphitepath = "#{config[:groupname]}.autoscaling.instance_count"
+    else
+      graphitepath = config[:scheme]
+    end
+    begin
+      as = AWS::AutoScaling.new aws_config
+      count = as.groups[config[:groupname]].auto_scaling_instances.map(&:lifecycle_state).count('InService')
+      output graphitepath, count
+    rescue => e
+      puts "Error: exception: #{e}"
+      critical
+    end
+    ok
+  end
+end

data/bin/check-dynamodb-capacity.rb

@@ -0,0 +1,183 @@
+#! /usr/bin/env ruby
+#
+# check-dynamodb-capacity
+#
+# DESCRIPTION:
+#   Check DynamoDB statuses by CloudWatch and DynamoDB API.
+#
+# OUTPUT:
+#   plain-text
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: aws-sdk
+#   gem: time
+#   gem: sensu-plugin
+#
+# USAGE:
+#   Warning if any table's consumed read/write capacity is over 80%, critical if over 90%
+#   check-dynamodb-capacity --warning-over 80 --critical-over 90
+#
+#   Critical if session table's consumed read capacity is over 90%, maximum of last one hour
+#   check-dynamodb-capacity --table_names session --capacity-for read --critical-over 90 --statistics maximum --period 3600
+#
+# NOTES:
+#
+# LICENSE:
+#   Copyright 2014 github.com/y13i
+#   Released under the same terms as Sensu (the MIT license); see LICENSE
+#   for details.
+#
+
+require 'rubygems' if RUBY_VERSION < '1.9.0'
+require 'sensu-plugin/check/cli'
+require 'aws-sdk'
+require 'time'
+
+class CheckDynamoDB < Sensu::Plugin::Check::CLI
+  option :access_key_id,
+         short:       '-k N',
+         long:        '--access-key-id ID',
+         description: 'AWS access key ID'
+
+  option :secret_access_key,
+         short:       '-s N',
+         long:        '--secret-access-key KEY',
+         description: 'AWS secret access key'
+
+  option :region,
+         short:       '-r R',
+         long:        '--region REGION',
+         description: 'AWS region'
+
+  option :table_names,
+         short:       '-t N',
+         long:        '--table-names NAMES',
+         proc:        proc { |a| a.split(/[,;]\s*/) },
+         description: 'Table names to check. Separated by , or ;. If not specified, check all tables'
+
+  option :end_time,
+         short:       '-t T',
+         long:        '--end-time TIME',
+         default:     Time.now,
+         proc:        proc { |a| Time.parse a },
+         description: 'CloudWatch metric statistics end time'
+
+  option :period,
+         short:       '-p N',
+         long:        '--period SECONDS',
+         default:     60,
+         # #YELLOW
+         proc:        proc(&:to_i),
+         description: 'CloudWatch metric statistics period'
+
+  option :statistics,
+         short:       '-S N',
+         long:        '--statistics NAME',
+         default:     :average,
+         proc:        proc { |a| a.downcase.intern },
+         description: 'CloudWatch statistics method'
+
+  option :capacity_for,
+         short:       '-c N',
+         long:        '--capacity-for NAME',
+         default:     [:read, :write],
+         proc:        proc { |a| a.split(/[,;]\s*/).map { |n| n.downcase.intern } },
+         description: 'Read/Write (or both) capacity to check.'
+
+  %w(warning critical).each do |severity|
+    option :"#{severity}_over",
+           long:        "--#{severity}-over N",
+           # #YELLOW
+           proc:        proc(&:to_f),
+           description: "Trigger a #{severity} if consumed capacity is over a percentage"
+  end
+
+  def aws_config
+    hash = {}
+    hash.update access_key_id: config[:access_key_id], secret_access_key: config[:secret_access_key] if config[:access_key_id] && config[:secret_access_key]
+    hash.update region: config[:region] if config[:region]
+    hash
+  end
+
+  def dynamo_db
+    @dynamo_db ||= AWS::DynamoDB.new aws_config
+  end
+
+  def cloud_watch
+    @cloud_watch ||= AWS::CloudWatch.new aws_config
+  end
+
+  def tables
+    return @tables if @tables
+    @tables = dynamo_db.tables.to_a
+    @tables.select! { |table| config[:table_names].include? table.name } if config[:table_names]
+    @tables
+  end
+
+  def cloud_watch_metric(metric_name, table_name)
+    cloud_watch.metrics.with_namespace('AWS/DynamoDB').with_metric_name(metric_name).with_dimensions(name: 'TableName', value: table_name).first
+  end
+
+  def statistics_options
+    {
+      start_time: config[:end_time] - config[:period],
+      end_time:   config[:end_time],
+      statistics: [config[:statistics].to_s.capitalize],
+      period:     config[:period]
+    }
+  end
+
+  def latest_value(metric)
+    metric.statistics(statistics_options.merge unit: 'Count').datapoints.sort_by { |datapoint| datapoint[:timestamp] }.last[config[:statistics]]
+  end
+
+  def flag_alert(severity, message)
+    @severities[severity] = true
+    @message += message
+  end
+
+  def check_capacity(table)
+    config[:capacity_for].each do |r_or_w|
+      metric_name   = "Consumed#{r_or_w.to_s.capitalize}CapacityUnits"
+      metric        = cloud_watch_metric metric_name, table.name
+      metric_value  = begin
+                        latest_value(metric)
+                      rescue
+                        0
+                      end
+      percentage    = metric_value / table.send("#{r_or_w}_capacity_units").to_f * 100
+
+      @severities.keys.each do |severity|
+        threshold = config[:"#{severity}_over"]
+        next unless threshold
+        next if percentage < threshold
+        flag_alert severity, "; On table #{table.name} consumed #{r_or_w} capacity is #{sprintf '%.2f', percentage}% (expected_lower_than #{threshold})"
+        break
+      end
+    end
+  end
+
+  def run
+    @message    = "#{tables.size} tables total"
+    @severities = {
+      critical: false,
+      warning:  false
+    }
+
+    tables.each { |table| check_capacity table }
+
+    @message += "; (#{config[:statistics].to_s.capitalize} within #{config[:period]} seconds "
+    @message += "between #{config[:end_time] - config[:period]} to #{config[:end_time]})"
+
+    if @severities[:critical]
+      critical @message
+    elsif @severities[:warning]
+      warning @message
+    else
+      ok @message
+    end
+  end
+end

data/bin/check-dynamodb-throttle.rb

@@ -0,0 +1,177 @@
+#! /usr/bin/env ruby
+#
+# check-dynamodb-throttle
+#
+# DESCRIPTION:
+#   Check DynamoDB throttle by CloudWatch and DynamoDB API.
+#
+# OUTPUT:
+#   plain-text
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: aws-sdk
+#   gem: time
+#   gem: sensu-plugin
+#
+# USAGE:
+#   Critical if session table's read throttle is over 50 for the last 5 minutes
+#   check-dynamodb-throttle --table_names session --throttle-for read --critical-over 50 --statistics sum --period 300
+#
+# NOTES:
+#
+# LICENSE:
+#   Copyright 2014 Sonian, Inc. and contributors. <support@sensuapp.org>
+#   Released under the same terms as Sensu (the MIT license); see LICENSE
+#   for details.
+#
+
+require 'rubygems' if RUBY_VERSION < '1.9.0'
+require 'sensu-plugin/check/cli'
+require 'aws-sdk'
+require 'time'
+
+class CheckDynamoDB < Sensu::Plugin::Check::CLI
+  option :access_key_id,
+         short:       '-k N',
+         long:        '--access-key-id ID',
+         description: 'AWS access key ID'
+
+  option :secret_access_key,
+         short:       '-s N',
+         long:        '--secret-access-key KEY',
+         description: 'AWS secret access key'
+
+  option :region,
+         short:       '-r R',
+         long:        '--region REGION',
+         description: 'AWS region'
+
+  option :table_names,
+         short:       '-t N',
+         long:        '--table-names NAMES',
+         proc:        proc { |a| a.split(/[,;]\s*/) },
+         description: 'Table names to check. Separated by , or ;. If not specified, check all tables'
+
+  option :end_time,
+         short:       '-t T',
+         long:        '--end-time TIME',
+         default:     Time.now,
+         proc:        proc { |a| Time.parse a },
+         description: 'CloudWatch metric statistics end time'
+
+  option :period,
+         short:       '-p N',
+         long:        '--period SECONDS',
+         default:     60,
+         proc:        proc(&:to_i),
+         description: 'CloudWatch metric statistics period'
+
+  option :statistics,
+         short:       '-S N',
+         long:        '--statistics NAME',
+         default:     :average,
+         proc:        proc { |a| a.downcase.intern },
+         description: 'CloudWatch statistics method'
+
+  option :throttle_for,
+         short:       '-c N',
+         long:        '--throttle-for NAME',
+         default:     [:read, :write],
+         proc:        proc { |a| a.split(/[,;]\s*/).map { |n| n.downcase.intern } },
+         description: 'Read/Write (or both) throttle to check.'
+
+  %w(warning critical).each do |severity|
+    option :"#{severity}_over",
+           long:        "--#{severity}-over N",
+           proc:        proc(&:to_f),
+           description: "Trigger a #{severity} if throttle is over the given number"
+  end
+
+  def aws_config
+    hash = {}
+    hash.update access_key_id: config[:access_key_id], secret_access_key: config[:secret_access_key] if config[:access_key_id] && config[:secret_access_key]
+    hash.update region: config[:region] if config[:region]
+    hash
+  end
+
+  def dynamo_db
+    @dynamo_db ||= AWS::DynamoDB.new aws_config
+  end
+
+  def cloud_watch
+    @cloud_watch ||= AWS::CloudWatch.new aws_config
+  end
+
+  def tables
+    return @tables if @tables
+    @tables = dynamo_db.tables.to_a
+    @tables.select! { |table| config[:table_names].include? table.name } if config[:table_names]
+    @tables
+  end
+
+  def cloud_watch_metric(metric_name, table_name)
+    cloud_watch.metrics.with_namespace('AWS/DynamoDB').with_metric_name(metric_name).with_dimensions(name: 'TableName', value: table_name).first
+  end
+
+  def statistics_options
+    {
+      start_time: config[:end_time] - config[:period],
+      end_time:   config[:end_time],
+      statistics: [config[:statistics].to_s.capitalize],
+      period:     config[:period]
+    }
+  end
+
+  def latest_value(metric)
+    metric.statistics(statistics_options.merge unit: 'Count').datapoints.sort_by { |datapoint| datapoint[:timestamp] }.last[config[:statistics]]
+  end
+
+  def flag_alert(severity, message)
+    @severities[severity] = true
+    @message += message
+  end
+
+  def check_throttle(table)
+    config[:throttle_for].each do |r_or_w|
+      metric_name   = "#{r_or_w.to_s.capitalize}ThrottleEvents"
+      metric        = cloud_watch_metric metric_name, table.name
+      metric_value  = begin
+                        latest_value(metric)
+                      rescue
+                        0
+                      end
+
+      @severities.keys.each do |severity|
+        threshold = config[:"#{severity}_over"]
+        next unless threshold
+        next if metric_value < threshold
+        flag_alert severity, "; On table #{table.name} #{r_or_w.to_s.capitalize}ThrottleEvents is #{metric_value} (higher_than #{threshold})"
+        break
+      end
+    end
+  end
+
+  def run
+    @message    = "#{tables.size} tables total"
+    @severities = {
+      critical: false,
+      warning: false
+    }
+
+    tables.each { |table| check_throttle table }
+
+    @message += "; (#{config[:statistics].to_s.capitalize} within #{config[:period]} seconds "
+    @message += "between #{config[:end_time] - config[:period]} to #{config[:end_time]})"
+
+    if @severities[:critical]
+      critical @message
+    elsif @severities[:warning]
+      warning @message
+    else
+      ok @message
+    end
+  end
+end