sensu-extensions-proc-net-snmp 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c931bf5cd14ebbe38f928543b3f0f395c0e90e19
+  data.tar.gz: 03c54773b5f05e54f4f75ce8fb879f7a7e8ec461
+SHA512:
+  metadata.gz: 9a80c662426d03045ed76985d3a4c48b0ad037fe5dcccced36785cd77f8f468135afce6cdf369f0ee0910967a96057c929f7c4cc5d827552dec74fb9dd9fc4b6
+  data.tar.gz: f8c6db980c4ecf8ac8303dd5d72ae2a8dd2abe80818267d0b8eeeb91640c77dd26cc25620db97dae4218aab30320146ac715b607513bdd58b8851a4f71b6c604

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/vendor/

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.ruby-version

@@ -0,0 +1 @@
+2.3.3

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.3
+before_install: gem install bundler -v 1.13.6

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Mitsutoshi Aoe
+
+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,146 @@
+# Sensu /proc/net/snmp metrics extension
+
+This check extension collects metrics in `/proc/net/snmp` on Linux and format them in the Graphite plaintext format. Sensu can send the collected metrics to Graphite or another TSDB as as InfluxDB.
+
+## Installation
+
+On a Sensu client machine:
+
+```
+sensu-install -e proc-net-snmp:0.0.1
+```
+
+Edit `/etc/sensu/conf.d/extensions.json` to load it:
+
+```json
+{
+  "extensions": {
+    "proc_net_snmp": {
+      "version": "0.0.1"
+    }
+  }
+}
+```
+or
+```json
+{
+  "extensions": {
+    "proc_net_snmp": {
+      "gem": "sensu-extensions-proc-net-snmp"
+    }
+  }
+}
+```
+
+Then restart the Sensu client:
+```
+sudo service sensu-client restart
+```
+
+## Configuration
+
+Edit `/etc/sensu/conf.d/proc_net_snmp.json` to change its configuration:
+```json
+{
+  "proc_net_snmp": {
+    "interval": 60,
+    "handler": "graphite",
+    "add_client_prefix": true,
+    "path_prefix": "proc.net.snmp",
+    "prefix_at_start": true
+  }
+}
+```
+and these are the default values.
+
+## Example output
+
+```
+com.sensuapp.demo.proc.net.snmp.ip.forwarding 1 1484531211
+com.sensuapp.demo.proc.net.snmp.ip.defaultttl 64 1484531211
+com.sensuapp.demo.proc.net.snmp.ip.inreceives 7224779 1484531211
+com.sensuapp.demo.proc.net.snmp.ip.inhdrerrors 0 1484531211
+com.sensuapp.demo.proc.net.snmp.ip.inaddrerrors 0 1484531211
+com.sensuapp.demo.proc.net.snmp.ip.forwdatagrams 1650817 1484531211
+com.sensuapp.demo.proc.net.snmp.ip.inunknownprotos 0 1484531211
+com.sensuapp.demo.proc.net.snmp.ip.indiscards 0 1484531211
+com.sensuapp.demo.proc.net.snmp.ip.indelivers 5573961 1484531211
+com.sensuapp.demo.proc.net.snmp.ip.outrequests 5287993 1484531211
+com.sensuapp.demo.proc.net.snmp.ip.outdiscards 44 1484531211
+com.sensuapp.demo.proc.net.snmp.ip.outnoroutes 0 1484531211
+com.sensuapp.demo.proc.net.snmp.ip.reasmtimeout 0 1484531211
+com.sensuapp.demo.proc.net.snmp.ip.reasmreqds 0 1484531211
+com.sensuapp.demo.proc.net.snmp.ip.reasmoks 0 1484531211
+com.sensuapp.demo.proc.net.snmp.ip.reasmfails 0 1484531211
+com.sensuapp.demo.proc.net.snmp.ip.fragoks 0 1484531211
+com.sensuapp.demo.proc.net.snmp.ip.fragfails 0 1484531211
+com.sensuapp.demo.proc.net.snmp.ip.fragcreates 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.inmsgs 170 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.inerrors 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.incsumerrors 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.indestunreachs 131 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.intimeexcds 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.inparmprobs 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.insrcquenchs 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.inredirects 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.inechos 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.inechoreps 39 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.intimestamps 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.intimestampreps 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.inaddrmasks 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.inaddrmaskreps 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.outmsgs 372 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.outerrors 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.outdestunreachs 225 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.outtimeexcds 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.outparmprobs 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.outsrcquenchs 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.outredirects 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.outechos 147 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.outechoreps 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.outtimestamps 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.outtimestampreps 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.outaddrmasks 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmp.outaddrmaskreps 0 1484531211
+com.sensuapp.demo.proc.net.snmp.icmpmsg.intype0 39 1484531211
+com.sensuapp.demo.proc.net.snmp.icmpmsg.intype3 131 1484531211
+com.sensuapp.demo.proc.net.snmp.icmpmsg.outtype3 225 1484531211
+com.sensuapp.demo.proc.net.snmp.icmpmsg.outtype8 147 1484531211
+com.sensuapp.demo.proc.net.snmp.tcp.rtoalgorithm 1 1484531211
+com.sensuapp.demo.proc.net.snmp.tcp.rtomin 200 1484531211
+com.sensuapp.demo.proc.net.snmp.tcp.rtomax 120000 1484531211
+com.sensuapp.demo.proc.net.snmp.tcp.maxconn -1 1484531211
+com.sensuapp.demo.proc.net.snmp.tcp.activeopens 73115 1484531211
+com.sensuapp.demo.proc.net.snmp.tcp.passiveopens 21 1484531211
+com.sensuapp.demo.proc.net.snmp.tcp.attemptfails 33777 1484531211
+com.sensuapp.demo.proc.net.snmp.tcp.estabresets 18421 1484531211
+com.sensuapp.demo.proc.net.snmp.tcp.currestab 22 1484531211
+com.sensuapp.demo.proc.net.snmp.tcp.insegs 5086735 1484531211
+com.sensuapp.demo.proc.net.snmp.tcp.outsegs 3427799 1484531211
+com.sensuapp.demo.proc.net.snmp.tcp.retranssegs 199 1484531211
+com.sensuapp.demo.proc.net.snmp.tcp.inerrs 120 1484531211
+com.sensuapp.demo.proc.net.snmp.tcp.outrsts 81584 1484531211
+com.sensuapp.demo.proc.net.snmp.tcp.incsumerrors 0 1484531211
+com.sensuapp.demo.proc.net.snmp.udp.indatagrams 587790 1484531211
+com.sensuapp.demo.proc.net.snmp.udp.noports 217 1484531211
+com.sensuapp.demo.proc.net.snmp.udp.inerrors 0 1484531211
+com.sensuapp.demo.proc.net.snmp.udp.outdatagrams 268892 1484531211
+com.sensuapp.demo.proc.net.snmp.udp.rcvbuferrors 0 1484531211
+com.sensuapp.demo.proc.net.snmp.udp.sndbuferrors 0 1484531211
+com.sensuapp.demo.proc.net.snmp.udp.incsumerrors 0 1484531211
+com.sensuapp.demo.proc.net.snmp.udplite.indatagrams 0 1484531211
+com.sensuapp.demo.proc.net.snmp.udplite.noports 0 1484531211
+com.sensuapp.demo.proc.net.snmp.udplite.inerrors 0 1484531211
+com.sensuapp.demo.proc.net.snmp.udplite.outdatagrams 0 1484531211
+com.sensuapp.demo.proc.net.snmp.udplite.rcvbuferrors 0 1484531211
+com.sensuapp.demo.proc.net.snmp.udplite.sndbuferrors 0 1484531211
+com.sensuapp.demo.proc.net.snmp.udplite.incsumerrors 0 1484531211
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/maoe/sensu-extensions-proc-net-snmp.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/lib/sensu/extensions/proc-net-snmp.rb

@@ -0,0 +1,114 @@
+require 'sensu/extension'
+require 'set'
+
+module Sensu
+  module Extension
+    class ProcNetSNMP < Check
+      def name
+        'proc_net_snmp'
+      end
+
+      def description
+        'collects metrics in /proc/net/snmp, using the graphite plain-text format'
+      end
+
+      def definition
+        {
+          type: 'metric',
+          name: name,
+          interval: options[:interval],
+          standalone: true,
+          handler: options[:handler]
+        }
+      end
+
+      def post_init
+        @metrics = []
+      end
+
+      def run
+        @metrics = []
+        proc_net_snmp_metrics do
+          yield flush_metrics, 0
+        end
+      end
+
+      private
+
+      def options
+        return @options if @options
+        @options = {
+          interval: 10,
+          handler: 'graphite',
+          add_client_prefix: true,
+          path_prefix: 'proc.net.snmp',
+          prefix_at_start: true
+        }
+        if settings && settings[:proc_net_snmp].is_a?(Hash)
+          @options.merge!(settings[:proc_net_snmp])
+        end
+        @options
+      end
+
+      def flush_metrics
+        metrics = @metrics.join("\n") + "\n"
+        @metrics = []
+        metrics
+      end
+
+      def add_metric(*args)
+        value = args.pop
+        path = []
+        path << options[:path_prefix] if options[:prefix_at_start]
+        path << settings[:client][:name] if options[:add_client_prefix]
+        path << options[:path_prefix] unless options[:prefix_at_start]
+        path = (path + args).join('.')
+        @metrics << [path, value, Time.now.to_i].join(' ')
+      end
+
+      def read_file(file_path, chunk_size = nil)
+        content = ''
+        File.open(file_path, 'r') do |file|
+          read_chunk = proc do
+            content << file.read(chunk_size)
+            # #YELLOW
+            unless file.eof? # rubocop:disable UnlessElse
+              EM.next_tick(read_chunk)
+            else
+              yield content
+            end
+          end
+          read_chunk.call
+        end
+      end
+
+      def proc_net_snmp_metrics
+        read_file('/proc/net/snmp') do |file|
+          protos = Set.new
+          metrics = []
+          file.each_line do |line|
+            proto, data = line.scan(/^([^:]+):\s+(.+)$/).first
+            fields = data.nil? ? [] : data.split(/\s+/)
+            if protos.member?(proto)
+              begin
+                values = fields.map {|s| Integer(s) }
+              rescue ArgumentError => e
+                next
+              end
+            else
+              protos << proto
+              metrics = fields
+              values = []
+            end
+            unless values.empty?
+              metrics.zip(values) do |metric, value|
+                add_metric(proto.downcase, metric.downcase, value)
+              end
+            end
+          end
+          yield
+        end
+      end
+    end
+  end
+end

data/sensu-extensions-proc-net-snmp.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+
+Gem::Specification.new do |spec|
+  spec.name          = "sensu-extensions-proc-net-snmp"
+  spec.version       = "0.0.1"
+  spec.authors       = ["Mitsutoshi Aoe"]
+  spec.email         = ["maoe@foldr.in"]
+
+  spec.summary       = %q{Collect metrics in /proc/net/snmp}
+  spec.description   = %q{Collect metrics in /proc/net/snmp}
+  spec.homepage      = "http://github.com/maoe/sensu-extensions-proc-net-snmp"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "sensu-extension"
+
+  spec.add_development_dependency "bundler", "~> 1.13"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "sensu-logger"
+  spec.add_development_dependency "sensu-settings"
+  spec.add_development_dependency "eventmachine"
+end

metadata

@@ -0,0 +1,152 @@
+--- !ruby/object:Gem::Specification
+name: sensu-extensions-proc-net-snmp
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Mitsutoshi Aoe
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-01-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sensu-extension
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: sensu-logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sensu-settings
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: eventmachine
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Collect metrics in /proc/net/snmp
+email:
+- maoe@foldr.in
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".ruby-version"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/sensu/extensions/proc-net-snmp.rb
+- sensu-extensions-proc-net-snmp.gemspec
+homepage: http://github.com/maoe/sensu-extensions-proc-net-snmp
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2
+signing_key: 
+specification_version: 4
+summary: Collect metrics in /proc/net/snmp
+test_files: []