sensu-plugins-aws-boutetnico 1.0.6

data/bin/check-elb-instances-inservice.rb

@@ -0,0 +1,103 @@
+#! /usr/bin/env ruby
+#
+# check-elb-instance-inservice
+#
+# DESCRIPTION:
+#   Check Elastic Loudbalancer Instances are inService.
+#
+# OUTPUT:
+#   plain-text
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: aws-sdk
+#   gem: sensu-plugin
+#
+# USAGE:
+#   all LoadBalancers
+#   ./check-elb-instance-inservice -r ${your_region}
+#   one loadBalancer
+#   ./check-elb-instance-inservice -r ${your_region} -l 'LoadBalancerName'
+#
+# NOTES:
+#   Based heavily on Peter Hoppe check-autoscaling-instances-inservices
+#
+# LICENSE:
+#   Peter Hoppe <peter.hoppe.extern@bertelsmann.de>
+#   Released under the same terms as Sensu (the MIT license); see LICENSE
+#   for details.
+#
+
+require 'sensu-plugin/check/cli'
+require 'aws-sdk'
+require 'sensu-plugins-aws'
+
+class CheckElbInstanceInService < 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:     ENV['AWS_REGION']
+
+  option :load_balancer,
+         short:       '-l L',
+         long:        '--load_balancer LoudBalancer',
+         description: 'LoadBalancer Name to check'
+
+  def elb
+    @elb ||= Aws::ElasticLoadBalancing::Client.new
+  end
+
+  def describe_elb(elb_name)
+    elb.describe_instance_health(
+      load_balancer_name: elb_name.to_s
+    )
+  end
+
+  def run
+    warning = 0
+    critical = 0
+    result = ''
+    if config[:load_balancer].nil?
+      elb.describe_load_balancers.load_balancer_descriptions.each do |load_balancer|
+        describe_elb(load_balancer.load_balancer_name).each do |instances|
+          instances.instance_states.each do |instance|
+            if instance.state == 'InService'
+              result += "#{instance.instance_id} state InService "
+            else
+              result += "#{instance.instance_id} state not InService "
+              warning += 1
+            end
+          end
+          if warning == instances.instance_states.length
+            critical = 1
+          end
+        end
+      end
+    else
+      describe_elb(config[:load_balancer]).each do |instances|
+        instances.instance_states.each do |instance|
+          if instance.state == 'InService'
+            result += "#{instance.instance_id} state InService "
+          else
+            result += "#{instance.instance_id} state not InService "
+            warning += 1
+          end
+        end
+        if warning == instances.instance_states.length
+          critical = 1
+        end
+      end
+    end
+    if critical == 1
+      critical result
+    elsif warning >= 1
+      warning result
+    else
+      ok result
+    end
+  end
+end

data/bin/check-elb-latency.rb

@@ -0,0 +1,166 @@
+#! /usr/bin/env ruby
+#
+# check-elb-latency
+#
+#
+# DESCRIPTION:
+#   This plugin checks the latency of an Amazon Elastic Load Balancer.
+#
+# OUTPUT:
+#   plain-text
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: aws-sdk
+#   gem: sensu-plugin
+#
+# USAGE:
+#   Warning if any load balancer's latency is over 1 second, critical if over 3 seconds.
+#   check-elb-latency --warning-over 1 --critical-over 3
+#
+#   Critical if "app" load balancer's latency is over 5 seconds, maximum of last one hour
+#   check-elb-latency --elb-names app --critical-over 5 --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 'sensu-plugin/check/cli'
+require 'sensu-plugins-aws'
+require 'aws-sdk'
+
+class CheckELBLatency < 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 :elb_names,
+         short:       '-l N',
+         long:        '--elb-names NAMES',
+         proc:        proc { |a| a.split(/[,;]\s*/) },
+         description: 'Load balancer names to check. Separated by , or ;. If not specified, check all load balancers'
+
+  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'
+
+  %w[warning critical].each do |severity|
+    option :"#{severity}_over",
+           long:        "--#{severity}-over SECONDS",
+           proc:        proc(&:to_f),
+           description: "Trigger a #{severity} if latancy is over specified seconds"
+  end
+
+  def elb
+    @elb ||= Aws::ElasticLoadBalancing::Client.new(aws_config)
+  end
+
+  def cloud_watch
+    @cloud_watch ||= Aws::CloudWatch::Client.new
+  end
+
+  def elbs
+    return @elbs if @elbs
+    @elbs = elb.describe_load_balancers.load_balancer_descriptions.to_a
+    @elbs.select! { |elb| config[:elb_names].include? elb.load_balancer_name } if config[:elb_names]
+    @elbs
+  end
+
+  def latency_metric(elb_name)
+    cloud_watch.get_metric_statistics(
+      namespace: 'AWS/ELB',
+      metric_name: 'Latency',
+      dimensions: [
+        {
+          name: 'LoadBalancerName',
+          value: elb_name
+        }
+      ],
+      start_time: config[:end_time] - config[:period],
+      end_time: config[:end_time],
+      statistics: [config[:statistics].to_s.capitalize],
+      period: config[:period],
+      unit: 'Seconds'
+    )
+  end
+
+  def latest_value(metric)
+    metric.datapoints.sort_by { |datapoint| datapoint[:timestamp] }.last[config[:statistics]]
+  end
+
+  def flag_alert(severity, message)
+    @severities[severity] = true
+    @message += message
+  end
+
+  def check_latency(elb)
+    metric        = latency_metric elb.load_balancer_name
+    metric_value  = begin
+                      latest_value metric
+                    rescue StandardError
+                      0
+                    end
+
+    @severities.each_key do |severity|
+      threshold = config[:"#{severity}_over"]
+      next unless threshold
+      next if metric_value < threshold
+      flag_alert severity,
+                 "; #{elbs.size == 1 ? nil : "#{elb.load_balancer_name}'s"} Latency is #{sprintf '%.3f', metric_value} seconds. (expected lower than #{sprintf '%.3f', threshold})"
+      break
+    end
+  end
+
+  def run
+    @message = if elbs.size == 1
+                 elbs.first.load_balancer_name
+               else
+                 "#{elbs.size} load balancers total"
+               end
+
+    @severities = {
+      critical: false,
+      warning:  false
+    }
+
+    elbs.each { |elb| check_latency elb }
+
+    @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-elb-nodes.rb

@@ -0,0 +1,133 @@
+#!/usr/bin/env ruby
+#
+# check-elb-nodes
+#
+# DESCRIPTION:
+#   This plugin checks an AWS Elastic Load Balancer to ensure a minimum number
+#   or percentage of nodes are InService on the ELB
+#
+# OUTPUT:
+#   plain-text
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: aws-sdk
+#   gem: sensu-plugin
+#
+# USAGE:
+#   Warning if the load balancer has 3 or fewer healthy nodes and critical if 2 or fewer
+#   check-elb-nodes --warn 3 --crit 2
+#
+#   Warning if the load balancer has 50% or less healthy nodes and critical if 25% or less
+#   check-elb-nodes --warn_perc 50 --crit_perc 25
+#
+# 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'
+
+class CheckELBNodes < 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 :load_balancer,
+         short: '-n ELB_NAME',
+         long: '--name ELB_NAME',
+         description: 'The name of the ELB',
+         required: true
+
+  option :warn_under,
+         short: '-w WARN_NUM',
+         long: '--warn WARN_NUM',
+         description: 'Minimum number of nodes InService on the ELB to be considered a warning',
+         default: -1,
+         proc: proc(&:to_i)
+
+  option :crit_under,
+         short: '-c CRIT_NUM',
+         long: '--crit CRIT_NUM',
+         description: 'Minimum number of nodes InService on the ELB to be considered critical',
+         default: -1,
+         proc: proc(&:to_i)
+
+  option :warn_percent,
+         short: '-W WARN_PERCENT',
+         long: '--warn_perc WARN_PERCENT',
+         description: 'Warn when the percentage of InService nodes is at or below this number',
+         default: -1,
+         proc: proc(&:to_i)
+
+  option :crit_percent,
+         short: '-C CRIT_PERCENT',
+         long: '--crit_perc CRIT_PERCENT',
+         description: 'Minimum percentage of nodes needed to be InService',
+         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
+    elb = Aws::ElasticLoadBalancing::Client.new(aws_config)
+
+    begin
+      instance_health = elb.describe_instance_health(load_balancer_name: config[:load_balancer])
+    rescue Aws::ElasticLoadBalancing::Errors::LoadBalancerNotFound
+      unknown "A load balancer with the name '#{config[:load_balancer]}' was not found"
+    end
+
+    num_instances = instance_health.instance_states.size
+    state = { 'OutOfService' => [], 'InService' => [], 'Unknown' => [] }
+    instance_health.instance_states.each do |instance|
+      state[instance.state] << instance.instance_id
+    end
+
+    message = "InService: #{state['InService'].count}"
+    if state['InService'].count > 0
+      message << " (#{state['InService'].join(', ')})"
+    end
+    message << "; OutOfService: #{state['OutOfService'].count}"
+    if state['OutOfService'].count > 0
+      message << " (#{state['OutOfService'].join(', ')})"
+    end
+    message << "; Unknown: #{state['Unknown'].count}"
+    if state['Unknown'].count > 0
+      message << " (#{state['Unknown'].join(', ')})"
+    end
+
+    if num_instances.zero?
+      critical 'ELB has no nodes'
+    elsif state['Unknown'].count == num_instances
+      unknown 'All nodes in unknown state'
+    elsif state['InService'].count.zero?
+      critical message
+    elsif config[:crit_under] > 0 && config[:crit_under] >= state['InService'].count
+      critical message
+    elsif config[:crit_percent] > 0 && config[:crit_percent] >= (state['InService'].count / num_instances) * 100
+      critical message
+    elsif config[:warn_under] > 0 && config[:warn_under] >= state['InService'].count
+      warning message
+    elsif config[:warn_percent] > 0 && config[:warn_percent] >= (state['InService'].count / num_instances) * 100
+      warning message
+    else
+      ok message
+    end
+  end
+end

data/bin/check-elb-sum-requests.rb

@@ -0,0 +1,157 @@
+#! /usr/bin/env ruby
+#
+# chwck-elb-sum-requests
+#
+# DESCRIPTION:
+#   Check ELB Sum Requests by CloudWatch API.
+#
+# OUTPUT:
+#   plain-text
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: aws-sdk
+#   gem: sensu-plugin
+#
+# USAGE:
+#   Warning if any load balancer's sum request count is over 1000, critical if over 2000.
+#   check-elb-sum-requests --warning-over 1000 --critical-over 2000
+#
+#   Critical if "app" load balancer's sum request count is over 10000, within last one hour
+#   check-elb-sum-requests --elb-names app --critical-over 10000 --period 3600
+#
+# NOTES:
+#
+# LICENSE:
+#   Copyright 2014 github.com/y13i
+#   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 CheckELBSumRequests < 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 :elb_names,
+         short:       '-l N',
+         long:        '--elb-names NAMES',
+         proc:        proc { |a| a.split(/[,;]\s*/) },
+         description: 'Load balancer names to check. Separated by , or ;. If not specified, check all load balancers'
+
+  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'
+
+  %w[warning critical].each do |severity|
+    option :"#{severity}_over",
+           long:        "--#{severity}-over COUNT",
+           proc:        proc(&:to_f),
+           description: "Trigger a #{severity} if sum requests is over specified count"
+  end
+
+  def elb
+    @elb ||= Aws::ElasticLoadBalancing::Client.new(aws_config)
+  end
+
+  def cloud_watch
+    @cloud_watch ||= Aws::CloudWatch::Client.new
+  end
+
+  def elbs
+    return @elbs if @elbs
+    @elbs = elb.describe_load_balancers.load_balancer_descriptions.to_a
+    @elbs.select! { |elb| config[:elb_names].include? elb.load_balancer_name } if config[:elb_names]
+    @elbs
+  end
+
+  def request_count_metric(elb_name)
+    cloud_watch.get_metric_statistics(
+      namespace: 'AWS/ELB',
+      metric_name: 'RequestCount',
+      dimensions: [
+        {
+          name: 'LoadBalancerName',
+          value: elb_name
+        }
+      ],
+      start_time: config[:end_time] - config[:period],
+      end_time: config[:end_time],
+      statistics: ['Sum'],
+      period: config[:period]
+    )
+  end
+
+  def latest_value(metric)
+    metric.datapoints.sort_by { |datapoint| datapoint[:timestamp] }.last[:sum]
+  end
+
+  def flag_alert(severity, message)
+    @severities[severity] = true
+    @message += message
+  end
+
+  def check_sum_requests(elb)
+    metric        = request_count_metric elb.load_balancer_name
+    metric_value  = begin
+                      latest_value metric
+                    rescue StandardError
+                      0
+                    end
+
+    @severities.each_key do |severity|
+      threshold = config[:"#{severity}_over"]
+      next unless threshold
+      next if metric_value < threshold
+      flag_alert severity,
+                 "; #{elbs.size == 1 ? nil : "#{elb.load_balancer_name}'s"} Sum Requests is #{metric_value}. (expected lower than #{threshold})"
+      break
+    end
+  end
+
+  def run
+    @message = if elbs.size == 1
+                 elbs.first.load_balancer_name
+               else
+                 "#{elbs.size} load balancers total"
+               end
+
+    @severities = {
+      critical: false,
+      warning:  false
+    }
+
+    elbs.each { |elb| check_sum_requests elb }
+
+    @message += "; (Sum 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