sensu-plugins-network-checks 0.0.1.alpha.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 313887c517630cb3ea1af2696f2177fd1d1dacc8
+  data.tar.gz: 711ccebf4a7a2487d5387a7f1d3e1e11728f678e
+SHA512:
+  metadata.gz: a1320cfabd4bc8ffb4ce71bcffe7bd709a017dda7e56809577024c8e02a4dbf3350874c38015b9ed8a4bef84c2effaca6ee14c7b5188bc793a0ef21cd95a0bf3
+  data.tar.gz: d05ed8213e49614af6e433a70436b4b895aedaff86cc6e8a873c60a024bc6658d0440444881575874133298cb924a128d6a3e81a56feb755f224969d27b123c5

checksums.yaml.gz.sig

@@ -0,0 +1 @@
+Q���ч8Q�7��<�іR?����e�P�~qz		mv��Ī�<W�7Y!sz

data.tar.gz.sig

@@ -0,0 +1,2 @@
+MF)���M�t|],�9f����`����@;�Mϋ"�ؘ}��x�4�ʵ)�2ެ#���3M6W����H��P��7���ͨ?Te:čC�լA�0d�#�e3��:>����nu�����R�1o�H���P�ڙS
+]Lo��*�����~�)^ت�1Gy�

data/CHANGELOG.md

@@ -0,0 +1,8 @@
+#### 0.1.0-alpha.1
+
+* initial release, same as community repo
+
+#### 0.1.0-alpha.2
+
+* all tests pass
+* initial gem release

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,71 @@
+
+[![Build Status](https://travis-ci.org/sensu-plugins/sensu-plugins-network-checks.svg?branch=master)](https://travis-ci.org/sensu-plugins/sensu-plugins-network-checks)
+[![Gem Version](https://badge.fury.io/rb/sensu-plugins-network-checks.svg)](http://badge.fury.io/rb/sensu-plugins-network-checks)
+[![Code Climate](https://codeclimate.com/github/sensu-plugins/sensu-plugins-network-checks/badges/gpa.svg)](https://codeclimate.com/github/sensu-plugins/sensu-plugins-network-checks)
+[![Test Coverage](https://codeclimate.com/github/sensu-plugins/sensu-plugins-network-checks/badges/coverage.svg)](https://codeclimate.com/github/sensu-plugins/sensu-plugins-network-checks)
+[![Dependency Status](https://gemnasium.com/sensu-plugins/sensu-plugins-network-checks.svg)](https://gemnasium.com/sensu-plugins/sensu-plugins-network-checks)
+
+## Functionality
+
+## Files
+ * bin/check-banner
+ * bin/check-multicast-groups
+ * bin/check-netstat-tcp
+ * bin/check-ping
+ * bin/check-ports
+ * bin/check-rbl
+ * bin/metrics-interface
+ * bin/metrics-net
+ * bin/metrics-netif
+ * bin/metrics-netstat-tcp
+
+## Usage
+
+**check-multicast-groups**
+```
+{
+  "check-multicast-groups": [
+    ["eth0", "224.2.2.4"]
+  ]
+}
+```
+## 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 sensu-plugins-network-checks -P MediumSecurity
+```
+
+You can also download the key from /certs/ within each repository.
+
+#### Rubygems
+
+`gem install sensu-plugins-network`
+
+#### Bundler
+
+Add *sensu-plugins-network* to your Gemfile and run `bundle install` or `bundle update`
+
+`gem install sensu-plugins-network-checks`
+
+#### Chef
+
+Using the Sensu **sensu_gem** LWRP
+```
+sensu_gem 'sensu-plugins-network-checks' do
+  options('--prerelease')
+  version '0.0.1.alpha.2'
+end
+```
+
+Using the Chef **gem_package** resource
+```
+gem_package 'sensu-plugins-network-checks' do
+  options('--prerelease')
+  version '0.0.1.alpha.2'
+end
+```
+
+## Notes

data/bin/check-banner.rb

@@ -0,0 +1,88 @@
+#! /usr/bin/env ruby
+#
+#   check-banner
+#
+# DESCRIPTION:
+#   Connect to a TCP port, read one line, test it against a pattern.
+#   Useful for SSH, ZooKeeper, etc.
+
+# OUTPUT:
+#   plain text
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: sensu-plugin
+#   gem: timeout
+#
+# USAGE:
+#
+# NOTES:
+#
+# LICENSE:
+#   Copyright 2012 Sonian, Inc <chefs@sonian.net>
+#   Released under the same terms as Sensu (the MIT license); see LICENSE
+#   for details.
+#
+
+require 'sensu-plugin/check/cli'
+require 'socket'
+require 'timeout'
+
+#
+# Check Banner
+#
+class CheckBanner < Sensu::Plugin::Check::CLI
+  option :host,
+         short: '-H HOSTNAME',
+         long: '--hostname HOSTNAME',
+         description: 'Host to connect to',
+         default: 'localhost'
+
+  option :port,
+         short: '-p PORT',
+         long: '--port PORT',
+         proc: proc(&:to_i),
+         default: 22
+
+  option :write,
+         short: '-w STRING',
+         long: '--write STRING',
+         description: 'write STRING to the socket'
+
+  option :pattern,
+         short: '-q PAT',
+         long: '--pattern PAT',
+         description: 'Pattern to search for',
+         default: 'OpenSSH'
+
+  option :timeout,
+         short: '-t SECS',
+         long: '--timeout SECS',
+         description: 'Connection timeout',
+         proc: proc(&:to_i),
+         default: 30
+
+  def acquire_banner # rubocop:disable all
+    timeout(config[:timeout]) do
+      sock = TCPSocket.new(config[:host], config[:port])
+      sock.puts config[:write] if config[:write]
+      sock.readline
+    end
+  rescue Errno::ECONNREFUSED
+    critical "Connection refused by #{config[:host]}:#{config[:port]}"
+  rescue Timeout::Error
+    critical 'Connection or read timed out'
+  rescue Errno::EHOSTUNREACH
+    critical 'Check failed to run: No route to host'
+  rescue EOFError
+    critical 'Connection closed unexpectedly'
+  end
+
+  def run
+    banner = acquire_banner
+    message banner
+    banner =~ /#{config[:pattern]}/ ? ok : warning
+  end
+end

data/bin/check-multicast-groups.rb

@@ -0,0 +1,77 @@
+#! /usr/bin/env ruby
+#
+#   check-multicasr-groups
+#
+# DESCRIPTION:
+#   This plugin checks if specific multicast groups are configured
+#   on specific interfaces. The netstat command is required.
+#
+#   The configurations can be put in the default sensu config directory
+#   and/or out of the sensu directory, as a JSON file. If the config file
+#   is not in the sensu directry, -c PATH option must be given.
+#
+# OUTPUT:
+#   plain text
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: sensu-plugin
+#   gem: json
+#   gem: set
+#
+# USAGE:
+#   example commands
+#
+# NOTES:
+#   Does it behave differently on specific platforms, specific use cases, etc
+#
+# LICENSE:
+# Copyright 2014 Mitsutoshi Aoe <maoe@foldr.in>
+#   Released under the same terms as Sensu (the MIT license); see LICENSE
+#   for details.
+#
+
+require 'json'
+require 'sensu-plugin/check/cli'
+require 'sensu-plugin/utils'
+require 'set'
+
+#
+# Check Multicast Groups
+#
+class CheckMulticastGroups < Sensu::Plugin::Check::CLI
+  include Sensu::Plugin::Utils
+
+  option :config,
+         short: '-c PATH',
+         long: '--config PATH',
+         required: true,
+         description: 'Path to a config file'
+
+  def run  # rubocop:disable all
+    targets = settings['check-multicast-groups'] ||= []
+    extras = load_config(config[:config])['check-multicast-groups'] || []
+    targets.deep_merge(extras)
+
+    critical 'No target muticast groups are specified.' if targets.empty?
+
+    iface_pat = /[a-zA-Z0-9\.]+/
+    refcount_pat = /\d+/
+    group_pat = /[a-f0-9\.:]+/ # assumes that -n is given
+    pattern = /(#{iface_pat})\s+#{refcount_pat}\s+(#{group_pat})/
+
+    actual = Set.new(`netstat -ng`.scan(pattern))
+    expected = Set.new(targets)
+
+    diff = expected.difference(actual)
+    if diff.size > 0
+      diff_output = diff.map { |iface, addr| "#{iface}\t#{addr}" }.join("\n")
+      critical "#{diff.size} missing multicast group(s):\n#{diff_output}"
+    end
+    ok
+  rescue => ex
+    critical "Failed to check multicast groups: #{ex}"
+  end
+end

data/bin/check-netstat-tcp.rb

@@ -0,0 +1,128 @@
+#! /usr/bin/env ruby
+#
+#   check-netstat-tcp
+#
+# DESCRIPTION:
+#   Alert based on thresholds of discrete TCP socket states reported by netstat
+#
+# OUTPUT:
+#   plain text
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: sensu-plugin
+#   gem: <?>
+#
+# USAGE:
+#   $ ./check-netstat-tcp.rb --states ESTABLISHED,CLOSE_WAIT --warning 10,3 --critical 100,30
+#
+# NOTES:
+#   - Thanks to metric-netstat-tcp.rb!
+#   https://github.com/sensu/sensu-community-plugins
+#   - Code for parsing Linux /proc/net/tcp from Anthony Goddard's ruby-netstat:
+#   https://github.com/agoddard/ruby-netstat
+#
+# LICENSE:
+#   Released under the same terms as Sensu (the MIT license); see LICENSE
+#   for details.
+#
+
+require 'sensu-plugin/check/cli'
+require 'socket'
+
+TCP_STATES = {
+  '00' => 'UNKNOWN',  # Bad state ... Impossible to achieve ...
+  'FF' => 'UNKNOWN',  # Bad state ... Impossible to achieve ...
+  '01' => 'ESTABLISHED',
+  '02' => 'SYN_SENT',
+  '03' => 'SYN_RECV',
+  '04' => 'FIN_WAIT1',
+  '05' => 'FIN_WAIT2',
+  '06' => 'TIME_WAIT',
+  '07' => 'CLOSE',
+  '08' => 'CLOSE_WAIT',
+  '09' => 'LAST_ACK',
+  '0A' => 'LISTEN',
+  '0B' => 'CLOSING'
+}
+
+#
+# Check Netstat TCP
+#
+class CheckNetstatTCP < Sensu::Plugin::Check::CLI
+  option :states,
+         description: 'Comma delimited list of states to check',
+         short: '-s STATES',
+         long: '--states STATES',
+         default: ['ESTABLISHED'],
+         proc: proc { |a| a.split(',') }
+
+  option :critical,
+         description: "Comma delimited list of state values to set critical at (order follows 'states')",
+         short: '-c CRITICAL',
+         long: '--critical CRITICAL',
+         default: [1000],
+         proc: proc { |a| a.split(',').map(&:to_i) }
+
+  option :warning,
+         description: "Comma delimited list of state values to set warning at (order follows 'states')",
+         short: '-w WARNING',
+         long: '--warning WARNING',
+         default: [500],
+         proc: proc { |a| a.split(',').map(&:to_i) }
+
+  option :port,
+         description: 'Port you wish to check values on (default: all)',
+         short: '-p PORT',
+         long: '--port PORT',
+         proc: proc(&:to_i)
+
+  def netstat(protocols = ['tcp'])  # rubocop:disable all
+    state_counts = Hash.new(0)
+    TCP_STATES.each_pair { |_hex, name| state_counts[name] = 0 }
+
+    protocols.select { |p| File.exist?('/proc/net/' + p) }.each do |protocol|
+      # #YELLOW
+      File.open('/proc/net/' + protocol).each do |line| # rubocop:disable Style/Next
+        line.strip!
+        if m = line.match(/^\s*\d+:\s+(.{8}|.{32}):(.{4})\s+(.{8}|.{32}):(.{4})\s+(.{2})/) # rubocop:disable AssignmentInCondition
+          connection_state = m[5]
+          connection_port = m[2].to_i(16)
+          connection_state = TCP_STATES[connection_state]
+          next unless config[:states].include?(connection_state)
+          if config[:port] && config[:port] == connection_port
+            state_counts[connection_state] += 1
+          elsif !config[:port]
+            state_counts[connection_state] += 1
+          end
+        end
+      end
+    end
+    state_counts
+  end
+
+  def run  # rubocop:disable all
+    state_counts = netstat(%w(tcp tcp6))
+    is_critical = false
+    is_warning = false
+    message = ''
+
+    config[:states].each_index do |i|
+      if state_counts[config[:states][i]] >= config[:critical][i]
+        is_critical = true
+        message += " CRITICAL:#{config[:states][i]}=#{state_counts[config[:states][i]]}"
+      elsif state_counts[config[:states][i]] >= config[:warning][i]
+        is_warning = true
+        message += " WARNING:#{config[:states][i]}=#{state_counts[config[:states][i]]}"
+      else
+        message += " OK:#{config[:states][i]}=#{state_counts[config[:states][i]]}"
+      end
+    end
+
+    critical message if is_critical
+    warning message if is_warning
+    ok message
+  end
+end

data/bin/check-ping.rb

@@ -0,0 +1,105 @@
+#! /usr/bin/env ruby
+#
+#  check-ping
+#
+# DESCRIPTION:
+#   This is a simple Ping check script for Sensu.
+#
+# OUTPUT:
+#   plain text
+#
+# PLATFORMS:
+#   Linux
+#
+# DEPENDENCIES:
+#   gem: sensu-plugin
+#   gem: net-ping
+#
+# USAGE:
+#   check-ping -h host -T timeout [--report]
+#
+# NOTES:
+#
+# LICENSE:
+#   Deepak Mohan Dass   <deepakmdass88@gmail.com>
+#   Released under the same terms as Sensu (the MIT license); see LICENSE
+#   for details.
+#
+
+require 'sensu-plugin/check/cli'
+require 'net/ping'
+
+#
+# Check Ping
+#
+class CheckPING < Sensu::Plugin::Check::CLI
+  option :host,
+         short: '-h host',
+         default: 'localhost'
+
+  option :timeout,
+         short: '-T timeout',
+         proc: proc(&:to_i),
+         default: 5
+
+  option :count,
+         short: '-c count',
+         description: 'The number of ping requests',
+         proc: proc(&:to_i),
+         default: 1
+
+  option :interval,
+         short: '-i interval',
+         description: 'The number of seconds to wait between ping requests',
+         proc: proc(&:to_f),
+         default: 1
+
+  option :warn_ratio,
+         short: '-W ratio',
+         description: 'Warn if successful ratio is under this value',
+         proc: proc(&:to_f),
+         default: 0.5
+
+  option :critical_ratio,
+         short: '-C ratio',
+         description: 'Critical if successful ratio is under this value',
+         proc: proc(&:to_f),
+         default: 0.2
+
+  option :report,
+         short: '-r',
+         long: '--report',
+         description: 'Attach MTR report if ping is failed',
+         default: false
+
+  def run # rubocop:disable all
+    result = []
+    pt = Net::Ping::External.new(config[:host], nil, config[:timeout])
+    config[:count].times do |i|
+      sleep(config[:interval]) unless i == 0
+      result[i] = pt.ping?
+    end
+
+    successful_count = result.count(true)
+    total_count = config[:count]
+    success_ratio = successful_count / total_count.to_f
+
+    if success_ratio > config[:warn_ratio]
+      success_message = "ICMP ping successful for host: #{config[:host]}"
+      ok success_message
+    else
+      failure_message = "ICMP ping unsuccessful for host: #{config[:host]} (successful: #{successful_count}/#{total_count})"
+
+      if config[:report]
+        report = `mtr --curses --report-cycles=1 --report --no-dns #{config[:host]}`
+        failure_message = failure_message + "\n" + report
+      end
+
+      if success_ratio <= config[:critical_ratio]
+        critical failure_message
+      else
+        warning failure_message
+      end
+    end
+  end
+end