sensu-plugins-aws 0.0.4 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9cece8a458614d75cb1de7e06e9ae6621f36d5b7
-  data.tar.gz: a2f8aa1261f5129b66b91ba8a78baccb59ee6595
+  metadata.gz: 952cc6ac4588a8609b48d4aee965beb1bbc756bb
+  data.tar.gz: 54466ee9bf3f405efdcb215498f3111b4f6ec099
 SHA512:
-  metadata.gz: 2c3ea581f55a1e0f2576a1f02dc7516ca01eaf43f41b0641a9a12a2ad4d90b72d6fb0900ba96c02e9cc07014113956f54ffd9197d6ddf85459196f83bccdbaf4
-  data.tar.gz: f88cfd661753410f3b42efb94cc82818d281ab8fdf65d05d4b0b88e986ddeec65b733a291c7a183005b3c7c88b88cae5dfbb2cd492cb58ea8a37d677c5eea914
+  metadata.gz: 14cfd437258092ca503dab2ed8bbcb97472846184116354cf0cce2919f264d6b45bcb339b72b5ee5ed704ed0092d026550a647b42eea74b3175136f5d43c2ca4
+  data.tar.gz: 0759bf875abeefdb0629066e460a81c8d02c4d8980cbf72fc0e9180a4fe86950c9b1d58045fcd85229fc3e8f060f95ca46d66173dcbe9a944afdfe730861e464

data/CHANGELOG.md

@@ -3,7 +3,27 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 This CHANGELOG follows the format listed at [Keep A Changelog](http://keepachangelog.com/)
 
-## Unreleased][unreleased]
+## [1.0.0] - 2015-07-22
+
+WARNING:  This release contains major breaking changes that will impact all users.  The flags used for access key and secret key have been standardized accross all plugins resulting in changed flags for the majority of plugins. The new flags are -a AWS_ACCESS_KEY and -k AWS_SECRET_KEY.
+
+### Added
+- EC2 node handler will now remove nodes terminated by a user
+- Transitioned EC2 node handler from fog to aws sdk v2
+- Allowed ignoring nil values returned from Cloudwatch in the check-rds plugin. Previously if Cloudwatch fell behind you would be alerted
+- Added support for checking multiple ELB instances at once by passing a comma separated list of ELB instance names in metrics-elb-full.rb
+- Added check-autoscaling-cpucredits.rb for checking T2 instances in autoscaling groups that are running low on CPU credits
+- Updated the fog and aws-sdk gems to the latest versions to improve performance, reduce 3rd party gem dependencies, and add support for newer AWS features.
+
+### Fixed
+- Renamed autoscaling-instance-count-metrics.rb -> metrics-autoscaling-instance-count.rb to match our naming scheme
+- Reworked check-rds-events.rb to avoid the ABCSize warning from rubocop
+- Corrected the list of plugins / files in the readme
+- Make ELB name a required flag for the metrics ELB plugins to prevent nil class errors when it isn't provided
+- Properly document that all plugins default to us-east-1 unless the region flag is passed
+- Fix the ELB metrics plugins to properly use the passed auth data
+- Fixed the metrics-elb-full plugin to still add the ELB instance name when a graphite schema is appended
+- Fixed all plugins to support passing the AWS access and secret keys from shell variables. Plugin help listed this as an option for all plugins, but the support wasn't actually there.
 
 ## [0.0.4] - 2015-07-05
 ### Added

data/README.md

@@ -9,14 +9,14 @@
 
 ## Functionality
 
-**check_vpc_vpn**
-
-**autoscaling-instance-count-metrics.rb**
+**check-autoscaling-cpucredits.rb**
 
 **check-dynamodb-capacity.rb**
 
 **check-dynamodb-throttle.rb**
 
+**check-ebs-snapshots.rb**
+
 **check-ec2-network.rb**
 
 **check-elb-certs.rb**
@@ -25,6 +25,8 @@
 
 **check-elb-health-sdk.rb**
 
+**check-elb-health.rb**
+
 **check-elb-latency.rb**
 
 **check-elb-nodes.rb**
@@ -43,30 +45,35 @@
 
 **check-sqs-messages.rb**
 
-**ec2-count-metrics.rb**
+**check_vpc_vpn.py**
+
+**handler-ec2_node.rb**
+
+**handler-sns.rb**
 
-**ec2-node.rb**
+**metrics-autoscaling-instance-count.rb**
 
-**elasticache-metrics.rb**
+**metrics-ec2-count.rb**
 
-**elb-full-metrics.rb**
+**metrics-elasticache.rb**
 
-**elb-latency-metrics.rb**
+**metrics-elb-full.rb**
 
-**elb-metrics.rb**
+**metrics-elb.rb**
 
-**sqs-metrics.rb**
+**metrics-sqs.rb**
 
 ## Files
 
-* /bin/check_vpc_vpn
-* /bin/autoscaling-instance-count-metrics.rb
+* /bin/check-autoscaling-cpucredits.rb
 * /bin/check-dynamodb-capacity.rb
 * /bin/check-dynamodb-throttle.rb
+* /bin/check-ebs-snapshots.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-health.rb
 * /bin/check-elb-latency.rb
 * /bin/check-elb-nodes.rb
 * /bin/check-elb-sum-requests.rb
@@ -76,11 +83,13 @@
 * /bin/check-redshift-events.rb
 * /bin/check-ses-limit.rb
 * /bin/check-sqs-messages.rb
+* /bin/check_vpc_vpn.py
+* /bin/handler-ec2_node.rb
+* /bin/handler-sns.rb
+* /bin/metrics-autoscaling-instance-count.rb
 * /bin/metrics-ec2-count.rb
-* /bin/handler-ec2-node.rb
 * /bin/metrics-elasticache.rb
 * /bin/metrics-elb-full.rb
-* /bin/metrics-elb-latency.rb
 * /bin/metrics-elb.rb
 * /bin/metrics-sqs.rb
 

data/bin/check-autoscaling-cpucredits.rb

@@ -0,0 +1,161 @@
+#! /usr/bin/env ruby
+#
+# check-autoscaling-cpucredits
+#
+# DESCRIPTION:
+#   Check AutoScaling CPU Credits through CloudWatch API.
+#
+# OUTPUT:
+#   plain-text
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: aws-sdk-v1
+#   gem: sensu-plugin
+#
+# USAGE:
+#   ./check-autoscaling-cpucredits.rb -r ${your_region} --warning-under 100 --critical-under 50
+#
+# NOTES:
+#   Based heavily on Yohei Kawahara's check-ec2-network
+#
+# LICENSE:
+#   Gavin Hamill <gavin@bashton.com>
+#   Released under the same terms as Sensu (the MIT license); see LICENSE
+#   for details.
+#
+
+require 'sensu-plugin/check/cli'
+require 'aws-sdk-v1'
+
+class CheckEc2CpuCredits < Sensu::Plugin::Check::CLI
+  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'] or provide it as an option",
+         default:     ENV['AWS_ACCESS_KEY']
+
+  option :aws_secret_access_key,
+         short:       '-k AWS_SECRET_KEY',
+         long:        '--aws-secret-access-key AWS_SECRET_KEY',
+         description: "AWS Secret Access Key. Either set ENV['AWS_SECRET_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 (defaults to us-east-1).',
+         default:     'us-east-1'
+
+  option :group,
+         short:       '-g G',
+         long:        '--autoscaling-group GROUP',
+         description: 'AutoScaling group to check'
+
+  option :end_time,
+         short:       '-t T',
+         long:        '--end-time TIME',
+         default:     Time.now,
+         description: 'CloudWatch metric statistics end time'
+
+  option :period,
+         short:       '-p N',
+         long:        '--period SECONDS',
+         default:     60,
+         description: 'CloudWatch metric statistics period'
+
+  option :countmetric,
+         short:       '-d M',
+         long:        '--countmetric METRIC',
+         default:     'CPUCreditBalance',
+         description: 'Select any CloudWatch _Count_ based metric (Status Checks / CPU Credits)'
+
+  option :warning_under,
+         short:       '-w N',
+         long:        '--warning-under VALUE',
+         description: 'Issue a warning if the CloudWatch _Count_ based metric (Status Check / CPU Credits) is below this value'
+
+  option :critical_under,
+         short:       '-c N',
+         long:        '--critical-under VALUE',
+         description: 'Issue a critical if the CloudWatch _Count_ based metric (Status Check / CPU Credits) is below this value'
+
+  def aws_config
+    { access_key_id: config[:aws_access_key],
+      secret_access_key: config[:aws_secret_access_key],
+      region: config[:aws_region]
+    }
+  end
+
+  def asg
+    @asg ||= AWS::AutoScaling.new aws_config
+  end
+
+  def cloud_watch
+    @cloud_watch ||= AWS::CloudWatch.new aws_config
+  end
+
+  def get_count_metric(group)
+    cloud_watch.metrics
+      .with_namespace('AWS/EC2')
+      .with_metric_name("#{config[:countmetric]}")
+      .with_dimensions(name: 'AutoScalingGroupName', value: group)
+      .first
+  end
+
+  def statistics_options
+    {
+      start_time: config[:end_time] - 600,
+      end_time:   config[:end_time],
+      statistics: ['Average'],
+      period:     config[:period]
+    }
+  end
+
+  def latest_value(metric)
+    value = metric.statistics(statistics_options.merge unit: 'Count')
+    value.datapoints[0][:average].to_f unless value.datapoints[0].nil?
+  end
+
+  def check_metric(group)
+    metric = get_count_metric group
+    latest_value metric
+  end
+
+  def check_group(group, reportstring, warnflag, critflag)
+    metric_value = check_metric group
+    if !metric_value.nil? && metric_value < config[:critical_under].to_f
+      critflag = 1
+      reportstring = reportstring + group + ': ' + metric_value.to_s + ' '
+    elsif !metric_value.nil? && metric_value < config[:warning_under].to_f
+      warnflag = 1
+      reportstring = reportstring + group + ': ' + metric_value.to_s + ' '
+    end
+    [reportstring, warnflag, critflag]
+  end
+
+  def run
+    warnflag = 0
+    critflag = 0
+    reportstring = ''
+    if config[:group].nil?
+      asg.groups.each do |group|
+        if group.desired_capacity > 0
+          reportstring, warnflag, critflag = check_group(group.name, reportstring, warnflag, critflag)
+        end
+      end
+    else
+      reportstring, warnflag, critflag = check_group(config[:group], reportstring, warnflag, critflag)
+    end
+
+    if critflag == 1
+      critical reportstring
+    elsif warnflag == 1
+      warning reportstring
+    else
+      ok 'All checked AutoScaling Groups are cool'
+    end
+  end
+end

data/bin/check-dynamodb-capacity.rb

@@ -12,8 +12,7 @@
 #   Linux
 #
 # DEPENDENCIES:
-#   gem: aws-sdk
-#   gem: time
+#   gem: aws-sdk-v1
 #   gem: sensu-plugin
 #
 # USAGE:
@@ -36,20 +35,23 @@ require 'aws-sdk-v1'
 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 :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'] or provide it as an option",
+         default:     ENV['AWS_ACCESS_KEY']
+
+  option :aws_secret_access_key,
+         short:       '-k AWS_SECRET_KEY',
+         long:        '--aws-secret-access-key AWS_SECRET_KEY',
+         description: "AWS Secret Access Key. Either set ENV['AWS_SECRET_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 (defaults to us-east-1).',
+         default:     'us-east-1'
 
   option :table_names,
          short:       '-t N',
@@ -95,10 +97,10 @@ class CheckDynamoDB < Sensu::Plugin::Check::CLI
   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
+    { access_key_id: config[:aws_access_key],
+      secret_access_key: config[:aws_secret_access_key],
+      region: config[:aws_region]
+    }
   end
 
   def dynamo_db

data/bin/check-dynamodb-throttle.rb

@@ -12,8 +12,7 @@
 #   Linux
 #
 # DEPENDENCIES:
-#   gem: aws-sdk
-#   gem: time
+#   gem: aws-sdk-v1
 #   gem: sensu-plugin
 #
 # USAGE:
@@ -33,20 +32,23 @@ require 'aws-sdk-v1'
 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 :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'] or provide it as an option",
+         default:     ENV['AWS_ACCESS_KEY']
+
+  option :aws_secret_access_key,
+         short:       '-k AWS_SECRET_KEY',
+         long:        '--aws-secret-access-key AWS_SECRET_KEY',
+         description: "AWS Secret Access Key. Either set ENV['AWS_SECRET_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 (defaults to us-east-1).',
+         default:     'us-east-1'
 
   option :table_names,
          short:       '-t N',
@@ -90,10 +92,10 @@ class CheckDynamoDB < Sensu::Plugin::Check::CLI
   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
+    { access_key_id: config[:aws_access_key],
+      secret_access_key: config[:aws_secret_access_key],
+      region: config[:aws_region]
+    }
   end
 
   def dynamo_db

data/bin/check-ec2-network.rb

@@ -12,7 +12,7 @@
 #   Linux
 #
 # DEPENDENCIES:
-#   gem: aws-sdk
+#   gem: aws-sdk-v1
 #   gem: sensu-plugin
 #
 # USAGE:
@@ -32,20 +32,23 @@ require 'sensu-plugin/check/cli'
 require 'aws-sdk-v1'
 
 class CheckEc2Network < 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 :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'] or provide it as an option",
+         default:     ENV['AWS_ACCESS_KEY']
+
+  option :aws_secret_access_key,
+         short:       '-k AWS_SECRET_KEY',
+         long:        '--aws-secret-access-key AWS_SECRET_KEY',
+         description: "AWS Secret Access Key. Either set ENV['AWS_SECRET_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 (defaults to us-east-1).',
+         default:     'us-east-1'
 
   option :instance_id,
          short:       '-i instance-id',
@@ -77,10 +80,10 @@ class CheckEc2Network < Sensu::Plugin::Check::CLI
   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
+    { access_key_id: config[:aws_access_key],
+      secret_access_key: config[:aws_secret_access_key],
+      region: config[:aws_region]
+    }
   end
 
   def ec2
@@ -106,10 +109,7 @@ class CheckEc2Network < Sensu::Plugin::Check::CLI
 
   def latest_value(metric)
     value = metric.statistics(statistics_options.merge unit: 'Bytes')
-    # #YELLOW
-    unless value.datapoints[0].nil? # rubocop:disable IfUnlessModifier, GuardClause
-      value.datapoints[0][:average].to_f
-    end
+    value.datapoints[0][:average].to_f unless value.datapoints[0].nil?
   end
 
   def check_metric(instance)