sensu-plugins-snmp 0.0.4 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0a3dc5871ee186fb00adf69e1ed79a306018c466
-  data.tar.gz: 0c1a1146ccafb8deeb21ab3a8248cb2f73b48064
+  metadata.gz: 3f7350b0daf73bd6077d7407eedcc0fcd8c996b0
+  data.tar.gz: 60155093f565f86579df5fb82819a12b36517107
 SHA512:
-  metadata.gz: c7484dd3e1342151d2180a042a04c984de7f8f7eeb48fbbc14b0323f420cf42821e3d1d40b501d881b35c30da78da2865155233740940d55afd54ad371a5e4af
-  data.tar.gz: 88d7c8bc2ab442e2b5d8c3432ee1db436a53d2fa4eddad1e13d1c84994c1fb644405e695d4e426f0aa4181dee3a1cad2e6f233b1082a0fae521699b07873856c
+  metadata.gz: b793699f8c01672a2fee7572737a5037ed8472676016d77e9898d7849534f54a9d2c942e3113578c4b8950eafb8ba15e5fe46523b15a94d57600c5afb499818a
+  data.tar.gz: 80311ba562bf6c80dc7464555d558d98d7fcb9bbe555972cfa570c1a533f4d46c156acbba4e1f0660d70d00388e8eb45dea0ccc6aea06364ffd26c3bdfe51b00

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/)
 
+## Unreleased
+
+## [0.1.0] - 2015-11-13
+### Added
+- Added a script check-snmp-disk, that checks disk utilization using SNMP
+
 ## [0.0.4] - 2015-07-22
 ### Fixed
 - Fixed graphite output when using a prefix in metrics-snmp-bulk.rb

data/README.md

@@ -1,6 +1,6 @@
 ## Sensu-Plugins-snmp
 
-[ ![Build Status](https://travis-ci.org/sensu-plugins/sensu-plugins-snmp.svg?branch=master)](https://travis-ci.org/sensu-plugins/sensu-plugins-snmp)
+[![Build Status](https://travis-ci.org/sensu-plugins/sensu-plugins-snmp.svg?branch=master)](https://travis-ci.org/sensu-plugins/sensu-plugins-snmp)
 [![Gem Version](https://badge.fury.io/rb/sensu-plugins-snmp.svg)](http://badge.fury.io/rb/sensu-plugins-snmp)
 [![Code Climate](https://codeclimate.com/github/sensu-plugins/sensu-plugins-snmp/badges/gpa.svg)](https://codeclimate.com/github/sensu-plugins/sensu-plugins-snmp)
 [![Test Coverage](https://codeclimate.com/github/sensu-plugins/sensu-plugins-snmp/badges/coverage.svg)](https://codeclimate.com/github/sensu-plugins/sensu-plugins-snmp)
@@ -11,6 +11,7 @@
 
 ## Files
  * bin/check-snmp.rb
+ * bin/check-snmp-disk.rb
  * bin/metrics-snmp-bulk.rb
  * bin/metrics-snmp-if.rb
  * bin/metrics-snmp.rb
@@ -19,6 +20,6 @@
 
 ## Installation
 
-[Installation and Setup](https://github.com/sensu-plugins/documentation/blob/master/user_docs/installation_instructions.md)
+[Installation and Setup](http://sensu-plugins.io/docs/installation_instructions.html)
 
 ## Notes

data/bin/check-snmp-disk.rb

@@ -0,0 +1,130 @@
+#! /usr/bin/env ruby
+#
+#   check-snmp-disk
+#
+# DESCRIPTION:
+#
+#   This is a simple SNMP check disk script for Sensu,
+#   The tool get a mount point as a regex and search for it in the device description SNMP table
+#   and return the utilization status based on warning and critical thresholds
+#
+# OUTPUT:
+#   plain text
+#
+# PLATFORMS:
+#
+# DEPENDENCIES:
+#   gem: sensu-plugin
+#   gem: SNMP
+#
+# USAGE:
+#   check-snmp -h host -C public -m /mnt -w 75 -c 85
+#
+#   if you want to search for specific device and not regex add a comma to the pattern:
+#   check-snmp -h host -C public -m /,
+#
+# NOTES:
+#   To search for device description in your server or applicance run the following command:
+#   snmpwalk -v2c -c public host 1.3.6.1.2.1.25.2.3.1.3
+#
+#  LICENSE:
+#    Yossi Nachum   <nachum234@gmail.com>
+#    Released under the same terms as Sensu (the MIT license); see LICENSE
+#    for details.
+#
+
+require 'sensu-plugin/check/cli'
+require 'snmp'
+
+class CheckSNMP < Sensu::Plugin::Check::CLI
+  option :host,
+         short: '-h host',
+         default: '127.0.0.1',
+         description: 'SNMP hostname'
+
+  option :community,
+         short: '-C snmp community',
+         default: 'public',
+         description: 'SNMP community'
+
+  option :mount_point,
+         short: '-m mount point',
+         default: '/',
+         description: 'Disk mount point'
+
+  option :ignoremnt,
+         short: '-i MNT[,MNT]',
+         description: 'Ignore mount point(s)',
+         proc: proc { |a| a.split(',') }
+
+  option :warning,
+         short: '-w warning',
+         proc: proc(&:to_i),
+         default: 80,
+         description: 'Warning threshold in precentage'
+
+  option :critical,
+         short: '-c critical',
+         proc: proc(&:to_i),
+         default: 90,
+         description: 'Critical threshold in precentage'
+
+  option :snmp_version,
+         short: '-v version',
+         description: 'SNMP version to use (SNMPv1, SNMPv2c (default))',
+         default: 'SNMPv2c'
+
+  option :timeout,
+         short: '-t timeout (seconds)',
+         default: '1',
+         description: 'SNMP timeout'
+
+  def initialize
+    super
+    @crit_mnt = []
+    @warn_mnt = []
+  end
+
+  def usage_summary
+    (@crit_mnt + @warn_mnt).join(', ')
+  end
+
+  def run
+    base_oid = '1.3.6.1.2.1.25.2.3.1'
+    dev_desc_oid = base_oid + '.3'
+    dev_size_oid = base_oid + '.5'
+    dev_used_oid = base_oid + '.6'
+    begin
+      manager = SNMP::Manager.new(host: "#{config[:host]}",
+                                  community: "#{config[:community]}",
+                                  version: config[:snmp_version].to_sym,
+                                  timeout: config[:timeout].to_i)
+      response = manager.get_bulk(0, 200, [dev_desc_oid])
+      dev_indexes = []
+      response.each_varbind do |var|
+        next if config[:ignoremnt] && config[:ignoremnt].include?(var.value.to_s.split(',')[0])
+        if var.value.to_s =~ /#{config[:mount_point]}/
+          dev_indexes.push(var.name[-1])
+        end
+      end
+      dev_indexes.each do |dev_index|
+        response = manager.get(["#{dev_desc_oid}.#{dev_index}", "#{dev_size_oid}.#{dev_index}", "#{dev_used_oid}.#{dev_index}"])
+        dev_desc, dev_size, dev_used = response.varbind_list
+        perc = dev_used.value.to_f / dev_size.value.to_f * 100
+        if perc > config[:critical]
+          @crit_mnt << "#{dev_desc.value} = #{perc.round(2)}%"
+        elsif perc > config[:warning]
+          @warn_mnt << "#{dev_desc.value} = #{perc.round(2)}%"
+        end
+      end
+    rescue SNMP::RequestTimeout
+      unknown "#{config[:host]} not responding"
+    rescue => e
+      unknown "An unknown error occured: #{e.inspect}"
+    end
+    critical usage_summary unless @crit_mnt.empty?
+    warning usage_summary unless @warn_mnt.empty?
+    ok "All disk usage under #{config[:warning]}%"
+    manager.close
+  end
+end

data/bin/metrics-snmp-bulk.rb

@@ -110,7 +110,7 @@ class SNMPGraphite < Sensu::Plugin::Metric::CLI::Graphite
         metric_string += ".#{config[:suffix]}" if config[:suffix]
         metric_string += ".#{name}"
         output metric_string, vb.value.to_f
-      rescue NameError # rubocop:disable all
+      rescue NameError # rubocop:disable Lint/HandleExceptions
         # Rescue as some values may fail to cast to float
       end
     end

data/bin/metrics-snmp-if.rb

@@ -118,7 +118,7 @@ class SNMPIfStatsGraphite < Sensu::Plugin::Metric::CLI::Graphite
          default: false,
          description: 'Use low capacity counters'
 
-  def run # rubocop:disable all
+  def run # rubocop:disable Metrics/AbcSize
     if_table_HC_columns = %w(
       ifHCInOctets ifHCOutOctets
       ifHCInUcastPkts ifHCOutUcastPkts

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

@@ -1,8 +1,8 @@
 module SensuPluginsSnmp
   module Version
     MAJOR = 0
-    MINOR = 0
-    PATCH = 4
+    MINOR = 1
+    PATCH = 0
 
     VER_STRING = [MAJOR, MINOR, PATCH].compact.join('.')
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sensu-plugins-snmp
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.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-11-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sensu-plugin
@@ -186,19 +186,25 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.10'
-description: Sensu plugins for SNMP
+description: |-
+  This plugin provides native SNMP instrumentation
+                                for monitoring and metrics collection, including:
+                                generic OID single/bulk query for status and
+                                metrics, and ifTable metrics
 email: "<sensu-users@googlegroups.com>"
 executables:
 - metrics-snmp.rb
 - metrics-snmp-if.rb
 - metrics-snmp-bulk.rb
 - check-snmp.rb
+- check-snmp-disk.rb
 extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
 - LICENSE
 - README.md
+- bin/check-snmp-disk.rb
 - bin/check-snmp.rb
 - bin/metrics-snmp-bulk.rb
 - bin/metrics-snmp-if.rb
@@ -231,7 +237,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.6
+rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
 summary: Sensu plugins for SNMP