sensu-plugins-aws-boutetnico 1.0.6

data/bin/check-ses-limit.rb

@@ -0,0 +1,89 @@
+#! /usr/bin/env ruby
+#
+# check-ses-limit
+#
+# DESCRIPTION:
+#   Gets your SES sending limit and issues a warn and critical based on percentages
+#   you supply for your daily sending limit
+#   Checks how close you are getting in percentages to your 24 hour ses sending limit
+#
+# OUTPUT:
+#   plain-text
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: aws-sdk
+#   gem: sensu-plugin
+#   gem: sensu-plugins-aws
+#
+# USAGE:
+#   #YELLOW
+#
+# NOTES:
+#
+# LICENSE:
+#   Copyright (c) 2014, Joel <jjshoe@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 CheckSESLimit < Sensu::Plugin::Check::CLI
+  include Common
+  option :aws_access_key,
+         short: '-a AWS_ACCESS_KEY',
+         long: '--aws-access-key AWS_ACCESS_KEY',
+         description: 'AWS Access Key ID.'
+
+  option :aws_secret_access_key,
+         short: '-k AWS_SECRET_KEY',
+         long: '--aws-secret-access-key AWS_SECRET_KEY',
+         description: 'AWS Secret Access 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 :warn_percent,
+         short: '-W WARN_PERCENT',
+         long: '--warn_perc WARN_PERCENT',
+         description: 'Warn when the percentage of mail sent is at or above this number',
+         default: 75,
+         proc: proc(&:to_i)
+
+  option :crit_percent,
+         short: '-C CRIT_PERCENT',
+         long: '--crit_perc CRIT_PERCENT',
+         description: 'Critical when the percentage of mail sent is at or above this number',
+         default: 90,
+         proc: proc(&:to_i)
+
+  def run
+    begin
+      ses = Aws::SES::Client.new
+      response = ses.get_send_quota
+    rescue StandardError => e
+      unknown "An issue occured while communicating with the AWS SES API: #{e.message}"
+    end
+
+    unknown 'Empty response from AWS SES API' if response.empty? # Can this happen?
+
+    percent = ((response.sent_last_24_hours.to_f / response.max_24_hour_send.to_f) * 100).to_i
+    message = "SES sending limit is at #{percent}%"
+
+    if config[:crit_percent] > 0 && config[:crit_percent] <= percent
+      critical message
+    elsif config[:warn_percent] > 0 && config[:warn_percent] <= percent
+      warning message
+    else
+      ok message
+    end
+  end
+end

data/bin/check-ses-statistics.rb

@@ -0,0 +1,149 @@
+#! /usr/bin/env ruby
+#
+# check-ses-statistics
+#
+# DESCRIPTION:
+#   Alerts on threshold values for SES statistics
+#
+# OUTPUT:
+#   plain-text
+#
+# DEPENDENCIES:
+#   gem: aws-sdk
+#   gem: sensu-plugin
+#
+# USAGE:
+#   check-ses-statistics.rb -r us-west-2 -b 1 -B 2 -c 5 -C 10 -j 10 -J 20
+#
+#   This will alert on bounces, complaints, rejects or delivery attempts
+#   if they equal or exceed (>=) threshold values,
+#
+#   It will alert on delivery attempts if they fall below (<) threshold values.
+#
+# NOTES:
+#
+# LICENSE:
+#   Brandon Smith <freedom@reardencode.com>
+#   Released under the same terms as Sensu (the MIT license); see LICENSE
+#   for details.
+
+require 'sensu-plugins-aws'
+require 'sensu-plugin/check/cli'
+require 'aws-sdk'
+
+class CheckSesStatistics < Sensu::Plugin::Check::CLI
+  include Common
+
+  option :aws_region,
+         short: '-r AWS_REGION',
+         long: '--aws-region REGION',
+         description: 'AWS Region (defaults to us-east-1).',
+         default: 'us-east-1'
+
+  option :low_delivery_warn,
+         short: '-l COUNT',
+         long: '--low_delivery_warn',
+         description: 'Number of delivery attempts to warn below.',
+         default: 0,
+         proc: proc(&:to_i)
+
+  option :low_delivery_crit,
+         short: '-L COUNT',
+         long: '--low_delivery_crit',
+         description: 'Number of delivery attempts to alert below.',
+         default: 0,
+         proc: proc(&:to_i)
+
+  option :delivery_warn,
+         short: '-d COUNT',
+         long: '--delivery_warn',
+         description: 'Number of delivery attempts to warn above.',
+         default: 0,
+         proc: proc(&:to_i)
+
+  option :delivery_crit,
+         short: '-D COUNT',
+         long: '--delivery_crit',
+         description: 'Number of delivery attempts to alert above.',
+         default: 0,
+         proc: proc(&:to_i)
+
+  option :complaint_warn,
+         short: '-c COUNT',
+         long: '--complaint_warn',
+         description: 'Number of complaints to warn above.',
+         default: 0,
+         proc: proc(&:to_i)
+
+  option :complaint_crit,
+         short: '-C COUNT',
+         long: '--complaint_crit',
+         description: 'Number of complaints to alert above.',
+         default: 0,
+         proc: proc(&:to_i)
+
+  option :reject_warn,
+         short: '-j COUNT',
+         long: '--reject_warn',
+         description: 'Number of rejects to warn above.',
+         default: 0,
+         proc: proc(&:to_i)
+
+  option :reject_crit,
+         short: '-J COUNT',
+         long: '--reject_crit',
+         description: 'Number of rejects to alert above.',
+         default: 0,
+         proc: proc(&:to_i)
+
+  option :bounce_warn,
+         short: '-b COUNT',
+         long: '--bounce_warn',
+         description: 'Number of bounces to warn above.',
+         default: 0,
+         proc: proc(&:to_i)
+
+  option :bounce_crit,
+         short: '-B COUNT',
+         long: '--bounce_crit',
+         description: 'Number of bounces to alert above.',
+         default: 0,
+         proc: proc(&:to_i)
+
+  def run
+    ses = Aws::SES::Client.new(aws_config)
+    begin
+      response = ses.get_send_statistics
+
+      unknown 'Empty response from AWS SES API' if response.empty? # Can this happen?
+      unknown 'No data points from AWS SES API' if response.send_data_points.empty?
+
+      data_point = response.send_data_points.sort_by(&:timestamp).last
+      bounces = data_point.bounces
+      rejects = data_point.rejects
+      complaints = data_point.complaints
+      delivery_attempts = data_point.delivery_attempts
+
+      message = "SES stats for #{data_point.timestamp}: "\
+        "#{delivery_attempts} delivery attempts, #{bounces} bounces, #{rejects} rejects, #{complaints} complaints"
+
+      if config[:complaint_crit] > 0 && config[:complaint_crit] <= complaints || \
+         config[:reject_crit] > 0 && config[:reject_crit] <= rejects || \
+         config[:bounce_crit] > 0 && config[:bounce_crit] <= bounces || \
+         config[:low_delivery_crit] > 0 && config[:low_delivery_crit] > bounces || \
+         config[:delivery_crit] > 0 && config[:delivery_crit] <= bounces
+
+        critical message
+      elsif config[:complaint_warn] > 0 && config[:complaint_warn] <= complaints || \
+            config[:reject_warn] > 0 && config[:reject_warn] <= rejects || \
+            config[:bounce_warn] > 0 && config[:bounce_warn] <= bounces || \
+            config[:low_delivery_warn] > 0 && config[:low_delivery_warn] > bounces || \
+            config[:delivery_warn] > 0 && config[:delivery_warn] <= bounces
+
+        warning message
+      else
+        ok message
+      end
+    end
+  end
+end

data/bin/check-sns-subscriptions.rb

@@ -0,0 +1,52 @@
+#! /usr/bin/env ruby
+#
+# check-sns-subscriptions
+#
+# DESCRIPTION:
+#   This plugin checks if topics's subscriptions are not 'PendingConfirmation' state.
+#
+# OUTPUT:
+#   plain-text
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: aws-sdk
+#   gem: sensu-plugin
+#
+# USAGE:
+#   ./check-sns-subscriptions.rb --aws-region eu-west-1
+#
+# NOTES:
+#
+# LICENSE:
+#   Copyright (c) 2016, Olivier Bazoud, olivier.bazoud@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 CheckSNSSubscriptions < Sensu::Plugin::Check::CLI
+  include Common
+
+  option :aws_region,
+         short: '-r AWS_REGION',
+         long: '--aws-region REGION',
+         description: 'AWS Region (defaults to us-east-1).',
+         default: 'us-east-1'
+
+  def run
+    sns = Aws::SNS::Client.new
+
+    subscriptions = sns.list_subscriptions.subscriptions
+
+    pending_confirmations = subscriptions.select { |subscription| subscription.subscription_arn == 'PendingConfirmation' }.map(&:topic_arn)
+
+    critical "#{pending_confirmations.size} pending confirmations (#{pending_confirmations})" unless pending_confirmations.empty?
+    ok
+  end
+end

data/bin/check-sqs-messages.rb

@@ -0,0 +1,168 @@
+#! /usr/bin/env ruby
+#
+# check-sqs-messages
+#
+# DESCRIPTION:
+#   This plugin checks the number of messages in an Amazon Web Services SQS queue.
+#
+# OUTPUT:
+#   plain-text
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: aws-sdk-v2
+#   gem: sensu-plugin
+#
+# USAGE:
+#   check-sqs-messages -q my_queue -w 500 -c 1000
+#   check-sqs-messages -p queue_prefix_ -W 100 -C 50
+#
+# NOTES:
+#
+# LICENSE:
+#   Copyright (c) 2013, Justin Lambert <jlambert@letsevenup.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'
+
+#
+# Check SQS Messages
+#
+class SQSMsgs < Sensu::Plugin::Check::CLI
+  include Common
+
+  option :aws_region,
+         short: '-r AWS_REGION',
+         long: '--aws-region REGION',
+         description: 'AWS Region (defaults to us-east-1).',
+         default: 'us-east-1'
+
+  option :queues,
+         short: '-q SQS_QUEUE',
+         long: '--queue SQS_QUEUE',
+         description: 'A comma seperated list of the SQS queue(s) you want to check the number of messages for',
+         default: [],
+         proc: proc { |q| q.split(',') }
+
+  option :exclude_queues,
+         short: '-Q SQS_QUEUES',
+         long: '--exclude-queues SQS_QUEUE',
+         description: 'A comma separated list of the SQS queue(s) to exclude, if using --prefix',
+         default: [],
+         proc: proc { |q| q.split(',') }
+
+  option :prefix,
+         short: '-p PREFIX',
+         long: '--prefix PREFIX',
+         description: 'The prefix of the queues you want to check the number of messages for',
+         default: ''
+
+  option :metric,
+         short: '-m METRIC',
+         long: '--metric METRIC',
+         description: 'The metric of the queues you want to check the number of messages for',
+         default: 'ApproximateNumberOfMessages'
+
+  option :warn_over,
+         short: '-w WARN_OVER',
+         long: '--warnnum WARN_OVER',
+         description: 'Number of messages in the queue considered to be a warning',
+         default: -1,
+         proc: proc(&:to_i)
+
+  option :crit_over,
+         short: '-c CRIT_OVER',
+         long: '--critnum CRIT_OVER',
+         description: 'Number of messages in the queue considered to be critical',
+         default: -1,
+         proc: proc(&:to_i)
+
+  option :warn_under,
+         short: '-W WARN_UNDER',
+         long: '--warnunder WARN_UNDER',
+         description: 'Minimum number of messages in the queue considered to be a warning',
+         default: -1,
+         proc: proc(&:to_i)
+
+  option :crit_under,
+         short: '-C CRIT_UNDER',
+         long: '--critunder CRIT_UNDER',
+         description: 'Minimum number of messages in the queue considered to be critical',
+         default: -1,
+         proc: proc(&:to_i)
+
+  def aws_config
+    { access_key_id: config[:aws_access_key],
+      secret_access_key: config[:aws_secret_access_key],
+      region: config[:aws_region] }
+  end
+
+  def run
+    Aws.config.update(aws_config)
+    sqs = Aws::SQS::Resource.new
+
+    if config[:prefix].empty?
+      if config[:queues].empty?
+        critical 'Error, either QUEUE or PREFIX must be specified'
+      end
+
+      warnings = []
+      crits = []
+      passing = []
+      queues = config[:queues]
+      queues.each do |q|
+        url = sqs.get_queue_by_name(queue_name: q).url
+        messages = sqs.client.get_queue_attributes(queue_url: url, attribute_names: ['All']).attributes[config[:metric]].to_i
+
+        if (config[:crit_under] >= 0 && messages < config[:crit_under]) || (config[:crit_over] >= 0 && messages > config[:crit_over])
+          crits << "#{messages} message(s) in #{q}"
+        elsif (config[:warn_under] >= 0 && messages < config[:warn_under]) || (config[:warn_over] >= 0 && messages > config[:warn_over])
+          warnings << "#{messages} message(s) in #{q}"
+        else
+          passing << "#{messages} message(s) in #{q}"
+        end
+      end
+      if crits.any?
+        critical crits.join(', ').to_s
+      elsif warnings.any?
+        warning warnings.join(', ').to_s
+      else
+        ok "all queue(s): #{queues} are OK"
+      end
+    else
+      warn = false
+      crit = false
+      queues = []
+      exclusions = config[:exclude_queues]
+
+      sqs.queues(queue_name_prefix: config[:prefix]).each do |q|
+        messages = sqs.client.get_queue_attributes(queue_url: q.url, attribute_names: ['All']).attributes[config[:metric]].to_i
+        queue_name = q.attributes['QueueArn'].split(':').last
+
+        next if exclusions.include? queue_name
+
+        if (config[:crit_under] >= 0 && messages < config[:crit_under]) || (config[:crit_over] >= 0 && messages > config[:crit_over])
+          crit = true
+          queues << "#{messages} message(s) in #{queue_name} queue"
+        elsif (config[:warn_under] >= 0 && messages < config[:warn_under]) || (config[:warn_over] >= 0 && messages > config[:warn_over])
+          warn = true
+          queues << "#{messages} message(s) in #{queue_name} queue"
+        end
+      end
+
+      if crit
+        critical queues.to_s
+      elsif warn
+        warning queues.to_s
+      else
+        ok "All queues matching prefix '#{config[:prefix]}' OK"
+      end
+    end
+  end
+end