collectd_gearman 0.1.0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in collectd_gearman.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Adrian Lopez
+
+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,105 @@
+# CollectdGearman
+
+/etc/collectd/collectd.conf.d/notification.conf
+```
+LoadPlugin exec
+# ...
+<Plugin exec>
+  NotificationExec "user" "/usr/local/bin/collectd_gearman"
+</Plugin>
+```
+
+/etc/collectd/nagios.yaml
+```
+gearman_server: localhost
+gearman_key: should_be_changed
+```
+
+
+## Configuration file
+/etc/collectd/nagios.yaml
+
+Could be defined in runtime with "-c" parameter.
+
+Options that could be defined:
+```
+gearman_server: localhost
+gearman_key: should_be_changed
+send_gearman: /usr/bin/send_gearman
+```
+
+## Examples
+df-threshold.txt
+```
+Severity: FAILURE
+Time: 1403985600.050
+Host: otro_client1.com
+Plugin: df
+PluginInstance: root
+Type: df_complex
+TypeInstance: used
+DataSource: value
+CurrentValue: 2.116443e+11
+WarningMin: nan
+WarningMax: 4.025360e+09
+FailureMin: 6.025350e+09
+FailureMax: 6.025360e+09
+```
+
+```
+$ cat df-threshold.txt | ruby -Ilib/ bin/collectd_gearman -s localhost -k KEY -v
+/usr/bin/send_gearman --server="localhost" --encryption=yes --key="KEY" --host="otro_client1.com" --service="df-root.df_complex-used" --message="Host otro_client1.com, plugin df (instance root) type df_complex (instance used): Data source 'value' is currently 211644297216.000000. That is above the failure threshold of 6025360000.000000." -r=2
+/usr/bin/send_gearman --server="localhost" --encryption=yes --key="KEY" --host="otro_client1.com" --service="df-root.df_complex" --message="Host otro_client1.com, plugin df (instance root) type df_complex (instance used): Data source 'value' is currently 211644297216.000000. That is above the failure threshold of 6025360000.000000." -r=2
+/usr/bin/send_gearman --server="localhost" --encryption=yes --key="KEY" --host="otro_client1.com" --service="df.df_complex-used" --message="Host otro_client1.com, plugin df (instance root) type df_complex (instance used): Data source 'value' is currently 211644297216.000000. That is above the failure threshold of 6025360000.000000." -r=2
+/usr/bin/send_gearman --server="localhost" --encryption=yes --key="KEY" --host="otro_client1.com" --service="df.df_complex" --message="Host otro_client1.com, plugin df (instance root) type df_complex (instance used): Data source 'value' is currently 211644297216.000000. That is above the failure threshold of 6025360000.000000." -r=2
+```
+
+
+disk-threshold.txt
+```
+Severity: FAILURE
+Time: 1403986248.700
+Host: otro_client1.com
+Plugin: disk
+PluginInstance: sda5
+Type: disk_octets
+DataSource: read
+CurrentValue: 2.047989e+03
+WarningMin: nan
+WarningMax: nan
+FailureMin: 9.900000e+01
+FailureMax: 1.000000e+02
+```
+
+```
+$ cat disk-threshold.txt | ruby -Ilib/ bin/collectd_gearman -s localhost -k KEY -v
+/usr/bin/send_gearman --server="localhost" --encryption=yes --key="KEY" --host="otro_client1.com" --service="disk-sda5.disk_octets.read" --message="Host otro_client1.com, plugin disk (instance sda5) type disk_octets: Data source 'read' is currently 2047.988533. That is above the failure threshold of 100.000000." -r=2
+/usr/bin/send_gearman --server="localhost" --encryption=yes --key="KEY" --host="otro_client1.com" --service="disk-sda5.disk_octets" --message="Host otro_client1.com, plugin disk (instance sda5) type disk_octets: Data source 'read' is currently 2047.988533. That is above the failure threshold of 100.000000." -r=2
+/usr/bin/send_gearman --server="localhost" --encryption=yes --key="KEY" --host="otro_client1.com" --service="disk.disk_octets" --message="Host otro_client1.com, plugin disk (instance sda5) type disk_octets: Data source 'read' is currently 2047.988533. That is above the failure threshold of 100.000000." -r=2
+```
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'collectd_gearman'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install collectd_gearman
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it ( http://github.com/<my-github-username>/collectd_gearman/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/collectd_gearman

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+
+#begin
+#  require 'rubygems'
+#  gem 'collectd_gearman'
+#rescue LoadError
+#end
+#CollectdGearman.application.run
+#
+require 'collectd_gearman'
+CollectdGearman::Application.run

data/collectd_gearman.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'collectd_gearman/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "collectd_gearman"
+  spec.version       = CollectdGearman::VERSION
+  spec.authors       = ["Adrian Lopez"]
+  spec.email         = ["adrianlzt@gmail.com"]
+  spec.summary       = %q{Convert collectd notifications in passive checks sent via send_gearman}
+  spec.description   = %q{Executable to be used with NotificationExec in collectd. It will send several passive checks, from specific to general plugin-type.}
+  spec.homepage      = "https://github.com/adrianlzt/collectd_gearman"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "rake"
+
+  spec.add_runtime_dependency 'yaml'
+  spec.add_runtime_dependency 'optparse'
+  spec.add_runtime_dependency 'ostruct'
+end

data/lib/collectd_gearman/application.rb

@@ -0,0 +1,153 @@
+require 'optparse'
+require 'yaml'
+require 'ostruct'
+
+module CollectdGearman
+
+  class Application
+    
+    CONF_FILE = "/etc/collectd/nagios.yaml"
+    SEND_GEARMAN_BIN = "/usr/bin/send_gearman"
+
+    def self.run
+      standard_exception_handling do
+        handle_options
+        data = read_stdin
+        send_commands data
+      end
+    end
+
+    def self.options
+      @options ||= OpenStruct.new
+    end
+
+    def self.handle_options
+      parse_args
+      read_conf
+      set_defaults
+      check_params
+    end
+
+    def self.parse_args
+      options.config_file = CONF_FILE
+
+      OptionParser.new do |opts|
+        opts.banner = "Usage: collectd_gearman [options]"
+
+        opts.on('-f', '--config FILE', 'Config file') { |v| options.config_file = v }
+        opts.on('-s', '--server SERVER', 'Gearman server') { |v| options.gearman_server = v }
+        opts.on('-k', '--key KEY', 'Gearman key') { |v| options.gearman_key = v }
+        opts.on('-g', '--send_gearman BIN', 'send_gearman binary') { |v| options.send_gearman = v }
+        opts.on('-v', '--verbose', 'verbose') { |v| options.verbose = v }
+
+        opts.on_tail("-h", "--help", "-H", "Display this help message.") do
+          puts opts
+          exit
+        end
+
+      end.parse!
+    end
+
+    def self.read_conf
+      return unless File.exist?(options.config_file)
+      file_config = YAML.load_file(options.config_file)
+      file_config.each do |k,v|
+        options.send("#{k}=",v) unless options.send(k)
+      end
+    end
+    
+    def self.set_defaults
+      options.send_gearman ||= SEND_GEARMAN_BIN
+    end
+
+    def self.check_params
+      raise "Gearman server must be defined" unless options.gearman_server
+      raise "Gearman key must be defined" unless options.gearman_key
+    end
+
+    # Read threshold data from Collectd
+    def self.read_stdin
+      data = {}
+      ARGF.each do |line|
+        if line =~ /^[a-zA-Z]+: .*/
+          data.merge!({line.split(": ").first => line.split(": ").last.strip})
+        else
+          data.merge!(message: line.strip)
+        end
+      end
+    
+      # DataSource = value is the same as nothing
+      data.delete("DataSource") if data["DataSource"] == "value"
+      data
+    end
+    
+    # Send passive checks to all posible services
+    def self.send_commands(data)
+      # Plugin-Instance.Type-Instance.DataSource
+      # Plugin-Instance.Type-Instance
+      # Plugin-Instance.Type.DataSource
+      # Plugin-Instance.Type
+      # Plugin.Type-Instance.DataSource
+      # Plugin.Type-Instance
+      # Plugin.Type.DataSource
+      # Plugin.Type
+      
+      if data["PluginInstance"] and data["TypeInstance"] and data["DataSource"]
+        send_gearman data["Host"],data[:message],data["Severity"],"#{data["Plugin"]}-#{data["PluginInstance"]}.#{data["Type"]}-#{data["TypeInstance"]}.#{data["DataSource"]}"
+      end
+      
+      if data["PluginInstance"] and data["TypeInstance"]
+        send_gearman data["Host"],data[:message],data["Severity"],"#{data["Plugin"]}-#{data["PluginInstance"]}.#{data["Type"]}-#{data["TypeInstance"]}"
+      end
+      
+      if data["PluginInstance"] and data["DataSource"]
+        send_gearman data["Host"],data[:message],data["Severity"],"#{data["Plugin"]}-#{data["PluginInstance"]}.#{data["Type"]}.#{data["DataSource"]}"
+      end
+      
+      if data["PluginInstance"]
+        send_gearman data["Host"],data[:message],data["Severity"],"#{data["Plugin"]}-#{data["PluginInstance"]}.#{data["Type"]}"
+      end
+      
+      if data["TypeInstance"] and data["DataSource"]
+        send_gearman data["Host"],data[:message],data["Severity"],"#{data["Plugin"]}.#{data["Type"]}-#{data["TypeInstance"]}.#{data["DataSource"]}"
+      end
+      
+      if data["TypeInstance"]
+        send_gearman data["Host"],data[:message],data["Severity"],"#{data["Plugin"]}.#{data["Type"]}-#{data["TypeInstance"]}"
+      end
+      
+      send_gearman data["Host"],data[:message],data["Severity"],"#{data["Plugin"]}.#{data["Type"]}"
+    end
+    
+    def self.send_gearman(host,message,severity,service)
+      case severity
+      when "FAILURE"
+        return_code = 2
+      when "WARNING"
+        return_code = 1
+      when "OKAY"
+        return_code = 0
+      else
+        return_code = 3
+      end
+    
+      cmd = "#{options.send_gearman} --server=\"#{options.gearman_server}\" --encryption=yes --key=\"#{options.gearman_key}\" --host=\"#{host}\" --service=\"#{service}\" --message=\"#{message.gsub('"',"'")}\" -r=#{return_code}"
+
+      raise "Command not found: #{options.send_gearman}" unless File.exist?(options.send_gearman)
+      
+      puts cmd if options.verbose
+
+      system cmd
+    end
+    
+    def self.standard_exception_handling
+      yield
+    rescue SystemExit
+      # Exit silently with current status
+      raise
+    rescue Exception => ex
+      $stderr.puts ex.message
+      exit(false)
+    end
+  end
+end

data/lib/collectd_gearman/version.rb

@@ -0,0 +1,3 @@
+module CollectdGearman
+  VERSION = "0.1.0"
+end

data/lib/collectd_gearman.rb

@@ -0,0 +1,5 @@
+require "collectd_gearman/application"
+require "collectd_gearman/version"
+
+module CollectdGearman
+end

metadata

@@ -0,0 +1,138 @@
+--- !ruby/object:Gem::Specification
+name: collectd_gearman
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Adrian Lopez
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-06-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yaml
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: optparse
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Executable to be used with NotificationExec in collectd. It will send
+  several passive checks, from specific to general plugin-type.
+email:
+- adrianlzt@gmail.com
+executables:
+- collectd_gearman
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/collectd_gearman
+- collectd_gearman.gemspec
+- lib/collectd_gearman.rb
+- lib/collectd_gearman/application.rb
+- lib/collectd_gearman/version.rb
+homepage: https://github.com/adrianlzt/collectd_gearman
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Convert collectd notifications in passive checks sent via send_gearman
+test_files: []