sensu-plugins-aws 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 952cc6ac4588a8609b48d4aee965beb1bbc756bb
-  data.tar.gz: 54466ee9bf3f405efdcb215498f3111b4f6ec099
+  metadata.gz: d1510edf78fde0477592736fb6a25174068aea6f
+  data.tar.gz: 3230a421cb5f4f07c7c8697b68500e9de59a480e
 SHA512:
-  metadata.gz: 14cfd437258092ca503dab2ed8bbcb97472846184116354cf0cce2919f264d6b45bcb339b72b5ee5ed704ed0092d026550a647b42eea74b3175136f5d43c2ca4
-  data.tar.gz: 0759bf875abeefdb0629066e460a81c8d02c4d8980cbf72fc0e9180a4fe86950c9b1d58045fcd85229fc3e8f060f95ca46d66173dcbe9a944afdfe730861e464
+  metadata.gz: ad8f2bbd6f05d6333383f53d8c0ab50922fad826c73e83c308042bf308c96eaa64f8b9effd80522a28922d201535ef2e0824d70ddfa6220dd8027ce7d2edcb6c
+  data.tar.gz: a47164e6147c093b74ac78d41df199ad1cfed09a7643e6e255647cb8c869f6a25b2175103caf96226955c0b2f90422aae7c0c40f34a328a242b7bfb0977a887b

data.tar.gz.sig

@@ -1,4 +1 @@
-%>l{3��EOHD�:�o����QfЦ�j�ZTܝ��q@.�I�bt
�#����/����If��CS����	�1��D<0w!L`�g�XM���T�W�hu�����Ow�#��]���
-E�0M�G�
-�3]�Rk���x�]	�2��#���@+b���ҧ�k����KmI.�Gr�O��R�ЏD�
-h}�ʺۇ>�
+�Ɋ;��GN����*u\V�r�����q�9zq���0�	T_�	�5�mR��`�`=�	%�N�;��Eb��s�_���&�"K5�W�,����<�c�]��g��&��^�,�e�1��ٗ����g8���N/Hو1<_�a��m0��c�ؗy%|˫~Uk,��;�SD~J����9�k8�qҍ"

data/CHANGELOG.md

@@ -3,6 +3,12 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 This CHANGELOG follows the format listed at [Keep A Changelog](http://keepachangelog.com/)
 
+## [1.1.0] - 2015-07-24 
+### Added
+- Added new AWS SES handler - handler-ses.rb
+- Add metrics-ec2-filter to store node ids and count matching a given filter
+- Check to alert on unlisted EIPs
+
 ## [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.

data/README.md

@@ -19,6 +19,8 @@
 
 **check-ec2-network.rb**
 
+**check-eip-allocation.rb**
+
 **check-elb-certs.rb**
 
 **check-elb-health-fog.rb**
@@ -49,12 +51,16 @@
 
 **handler-ec2_node.rb**
 
+**handler-ses.rb**
+
 **handler-sns.rb**
 
 **metrics-autoscaling-instance-count.rb**
 
 **metrics-ec2-count.rb**
 
+**metrics-ec2-filter.rb**
+
 **metrics-elasticache.rb**
 
 **metrics-elb-full.rb**
@@ -63,6 +69,7 @@
 
 **metrics-sqs.rb**
 
+
 ## Files
 
 * /bin/check-autoscaling-cpucredits.rb
@@ -85,9 +92,11 @@
 * /bin/check-sqs-messages.rb
 * /bin/check_vpc_vpn.py
 * /bin/handler-ec2_node.rb
+* /bin/handler-ses.rb
 * /bin/handler-sns.rb
 * /bin/metrics-autoscaling-instance-count.rb
 * /bin/metrics-ec2-count.rb
+* /bin/metrics-ec2-filter.rb
 * /bin/metrics-elasticache.rb
 * /bin/metrics-elb-full.rb
 * /bin/metrics-elb.rb
@@ -95,19 +104,36 @@
 
 ## Usage
 
+**handler-ses**
+```
+{
+  "ses": {
+    "mail_from": "sensu@example.com",
+    "mail_to": "monitor@example.com",
+    "use_ami_role": true,
+    "access_key": "myaccesskey",
+    "secret_key": "mysecretkey",
+    "region": "us-east-1",
+    "subscriptions": {
+      "subscription_name": {
+        "mail_to": "teamemail@example.com"
+      }
+    }
+  }
+}
+```
+
 **handler-sns**
 ```
 {
   "sns": {
-    "topic_arn": "arn:aws:sns:us-east-1:111111111111:topic"
-    ,"use_ami_role": true
-    ,"access_key": "MY_KEY"
-    ,"secret_key": "MY_secret"
+    "topic_arn": "arn:aws:sns:us-east-1:111111111111:topic",
+    "use_ami_role": true,
+    "access_key": "MY_KEY",
+    "secret_key": "MY_secret"
   }
 }
 ```
 ## Installation
 
 [Installation and Setup](https://github.com/sensu-plugins/documentation/blob/master/user_docs/installation_instructions.md)
-
-## Notes

data/bin/check-eip-allocation.rb

@@ -0,0 +1,64 @@
+#! /usr/bin/env ruby
+#
+# check-ebs-snapshots
+#
+# DESCRIPTION:
+#   Alert on new eip allocations
+#
+# OUTPUT:
+#   plain-text
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: aws-sdk
+#   gem: sensu-plugin
+#
+# USAGE:
+#   ./check-eip-allocation.rb -r ${you_region} -e ${eips_allowed}
+#
+# NOTES:
+#
+# LICENSE:
+#   Shane Starcher <shane.starcher@gmail.com>
+#   Released under the same terms as Sensu (the MIT license); see LICENSE
+#   for details.
+#
+
+require 'sensu-plugin/check/cli'
+require 'sensu-plugins-aws'
+require 'aws-sdk'
+
+class CheckEipAllocation < Sensu::Plugin::Check::CLI
+  include Common
+  option :eips_allowed,
+         short:       '-e EIPS_ALLOWED',
+         long:        '--eips_allowed eip1,eip2',
+         required: 	  true,
+         description: 'List of EIPs that are allowed to exist.  Comma seperated.'
+
+  option :aws_region,
+         short:       '-r R',
+         long:        '--region REGION',
+         description: 'AWS region',
+         default: 'us-east-1'
+
+  def run
+    errors = []
+    ec2 = Aws::EC2::Client.new
+
+    eips = ec2.describe_addresses
+    eips[:addresses].each do |eip|
+      unless config[:eips_allowed].include? eip.public_ip
+        errors << eip.public_ip
+      end
+    end
+
+    if errors.empty?
+      ok
+    else
+      warning errors.join("\n")
+    end
+  end
+end

data/bin/handler-ses.rb

@@ -0,0 +1,116 @@
+#!/usr/bin/env ruby
+#
+#
+# This handler formats alerts as mails and sends them off to a pre-defined recipient.
+#
+# Requires the aws-sdk gem.
+#
+# Setting required in ses.json
+#
+# Released under the same terms as Sensu (the MIT license); see LICENSE
+# for details.
+
+require 'sensu-handler'
+require 'aws-sdk-v1'
+
+class SESNotifier < Sensu::Handler
+  def event_name
+    @event['client']['name'] + '/' + @event['check']['name']
+  end
+
+  def action_to_string
+    @event['action'].eql?('resolve') ? 'RESOLVED' : 'ALERT'
+  end
+
+  def status_to_string
+    case @event['check']['status']
+    when 0
+      'OK'
+    when 1
+      'WARNING'
+    when 2
+      'CRITICAL'
+    else
+      'UNKNOWN'
+    end
+  end
+
+  def mail_from
+    settings['ses']['mail_from'] || ''
+  end
+
+  def build_mail_to_list
+    json_config = config[:json_config] || 'ses'
+    mail_to = @event['client']['mail_to'] || settings[json_config]['mail_to']
+    if settings[json_config].key?('subscriptions')
+      @event['check']['subscribers'].each do |sub|
+        if settings[json_config]['subscriptions'].key?(sub)
+          mail_to << ", #{settings[json_config]['subscriptions'][sub]['mail_to']}"
+        end
+      end
+    end
+    mail_to
+  end
+
+  def use_ami_role
+    use_ami_role = settings['ses']['use_ami_role']
+    use_ami_role.nil? ? true : use_ami_role
+  end
+
+  def aws_access_key
+    settings['ses']['access_key'] || ''
+  end
+
+  def aws_access_secret
+    settings['ses']['secret_key'] || ''
+  end
+
+  def region
+    settings['ses']['region'] || 'us-east-1'
+  end
+
+  def handle
+    mail_to = build_mail_to_list
+    body = <<-BODY.gsub(/^ {14}/, '')
+            #{@event['check']['output']}
+            Host: #{@event['client']['name']}
+            Timestamp: #{Time.at(@event['check']['issued'])}
+            Address:  #{@event['client']['address']}
+            Check Name:  #{@event['check']['name']}
+            Command:  #{@event['check']['command']}
+            Status:  #{@event['check']['status']}
+            Occurrences:  #{@event['occurrences']}
+          BODY
+
+    if @event['check']['notification'].nil?
+      subject = "#{action_to_string} - #{event_name}: #{status_to_string}"
+    else
+      subject = "#{action_to_string} - #{event_name}: #{@event['check']['notification']}"
+    end
+
+    if use_ami_role
+      AWS.config(region: region)
+    else
+      AWS.config(access_key_id: aws_access_key,
+                 secret_access_key: aws_access_secret,
+                 region: region)
+    end
+
+    ses = AWS::SimpleEmailService.new
+
+    begin
+      timeout 10 do
+        ses.send_email(
+          subject: subject,
+          from: mail_from,
+          to: [mail_to.split(',')],
+          body_text: body
+        )
+
+        puts 'mail -- sent alert for ' + event_name + ' to ' + mail_to.to_s
+      end
+    rescue Timeout::Error
+      puts 'mail -- timed out while attempting to ' + @event['action'] + ' an incident -- ' + event_name
+    end
+  end
+end

data/bin/metrics-ec2-filter.rb

@@ -0,0 +1,130 @@
+#! /usr/bin/env ruby
+#
+# metrics-ec2-filter
+#
+# DESCRIPTION:
+#   This plugin retrieves EC2 instances matching a given filter
+#
+# OUTPUT:
+#   plain-text
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: aws-sdk
+#   gem: sensu-plugin
+#
+# USAGE:
+#   ./metrics-ec2-filter.rb -f "{name:tag-value,values:[infrastructure]}"
+#   ./metrics-ec2-filter.rb -f "{name:tag-value,values:[infrastructure]} {name:instance-state-name,values:[running]}"
+#
+# NOTES:
+#
+# LICENSE:
+#   Justin McCarty
+#   Released under the same terms as Sensu (the MIT license); see LICENSE
+#   for details.
+#
+
+require 'sensu-plugin/metric/cli'
+require 'aws-sdk'
+
+class EC2Filter < Sensu::Plugin::Metric::CLI::Graphite
+  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 :name,
+         description: 'Filter naming scheme, text to prepend to metric',
+         short: '-n NAME',
+         long: '--name NAME',
+         default: ''
+
+  option :filter,
+         short: '-f FILTER',
+         long: '--filter FILTER',
+         description: 'String representation of the filter to apply',
+         default: '{}'
+
+  option :scheme,
+         description: 'Metric naming scheme, text to prepend to metric',
+         short: '-s SCHEME',
+         long: '--scheme SCHEME',
+         default: 'sensu.aws.ec2'
+
+  def aws_config
+    { access_key_id: config[:aws_access_key],
+      secret_access_key: config[:aws_secret_access_key],
+      region: config[:aws_region]
+    }
+  end
+
+  def convert_filter(input)
+    filter = []
+    items = input.scan(/{.*?}/)
+
+    items.each do |item|
+      if item.strip.empty?
+        fail 'Invalid filter syntax'
+      end
+
+      entry = {}
+      name = item.scan(/name:(.*?),/)
+      value = item.scan(/values:\[(.*?)\]/)
+
+      if name.nil? || name.empty? || value.nil? || value.empty?
+        fail 'Unable to parse filter entry'
+      end
+
+      entry[:name] = name[0][0].strip
+      entry[:values] = value[0][0].split(',')
+      filter << entry
+    end
+    filter
+  end
+
+  def run
+    begin
+      client = Aws::EC2::Client.new aws_config
+
+      filter = convert_filter(config[:filter])
+
+      options = { filters: filter }
+
+      data = client.describe_instances(options)
+
+      instance_ids = Set.new
+      scheme = config[:scheme]
+
+      unless config[:name].empty?
+        scheme += ".#{config[:name]}"
+      end
+      data[:reservations].each do |res|
+        res[:instances].each do |i|
+          instance_ids << i[:instance_id]
+          output scheme + ".ids.#{i[:instance_id]}"
+        end
+      end
+      output scheme + ".count.#{instance_ids.count}"
+    rescue => e
+      puts "Error: exception: #{e}"
+      critical
+    end
+    ok
+  end
+end

data/lib/sensu-plugins-aws/version.rb

@@ -5,7 +5,7 @@ module SensuPluginsAWS
   # This defines the version of the gem
   module Version
     MAJOR = 1
-    MINOR = 0
+    MINOR = 1
     PATCH = 0
 
     VER_STRING = [MAJOR, MINOR, PATCH].compact.join('.')

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sensu-plugins-aws
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Sensu-Plugins and contributors
@@ -30,7 +30,7 @@ cert_chain:
   8sHuVruarogxxKPBzlL2is4EUb6oN/RdpGx2l4254+nyR+abg//Ed27Ym0PkB4lk
   HP0m8WSjZmFr109pE/sVsM5jtOCvogyujQOjNVGN4gz1wwPr
   -----END CERTIFICATE-----
-date: 2015-07-22 00:00:00.000000000 Z
+date: 2015-07-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sensu-plugin
@@ -235,9 +235,11 @@ executables:
 - metrics-elb.rb
 - metrics-elb-full.rb
 - metrics-elasticache.rb
+- metrics-ec2-filter.rb
 - metrics-ec2-count.rb
 - metrics-autoscaling-instance-count.rb
 - handler-sns.rb
+- handler-ses.rb
 - handler-ec2_node.rb
 - check_vpc_vpn.py
 - check-sqs-messages.rb
@@ -253,6 +255,7 @@ executables:
 - check-elb-health-sdk.rb
 - check-elb-health-fog.rb
 - check-elb-certs.rb
+- check-eip-allocation.rb
 - check-ec2-network.rb
 - check-ebs-snapshots.rb
 - check-dynamodb-throttle.rb
@@ -269,6 +272,7 @@ files:
 - bin/check-dynamodb-throttle.rb
 - bin/check-ebs-snapshots.rb
 - bin/check-ec2-network.rb
+- bin/check-eip-allocation.rb
 - bin/check-elb-certs.rb
 - bin/check-elb-health-fog.rb
 - bin/check-elb-health-sdk.rb
@@ -284,9 +288,11 @@ files:
 - bin/check-sqs-messages.rb
 - bin/check_vpc_vpn.py
 - bin/handler-ec2_node.rb
+- bin/handler-ses.rb
 - bin/handler-sns.rb
 - bin/metrics-autoscaling-instance-count.rb
 - bin/metrics-ec2-count.rb
+- bin/metrics-ec2-filter.rb
 - bin/metrics-elasticache.rb
 - bin/metrics-elb-full.rb
 - bin/metrics-elb.rb