bluepill-gearman 1.0.0

data/.gitignore

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

data/.rbenv-version

@@ -0,0 +1 @@
+1.9.3-p392

data/Changelog.md

@@ -0,0 +1,2 @@
+# v0.0.1
+* Initial release - no encryption - olny encoded64 jobs

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Ami Mahloof
+
+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,56 @@
+# Bluepill::Gearman
+
+Send bluepill events(passive checks) to gearman server via send gearman
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'bluepill-gearman', 
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install bluepill-gearman
+
+## Usage
+
+Require the bluepill-gearman gem and add a check named :send_gearman in your pill configuration file.
+
+Available options are:
+  * gearman_server: the Gearman Server. mandatory
+  * gearman_port: the gearman server port or default to 4730
+  * host: the host defined in nagios to be hosting the service (default: hostname -f)
+  * service: the service declared in nagios (default: the bluepill process name)
+  * queue: default queue is 'check_results'
+  * key: provide a key for encryption (minimum 8 bytes)
+  * encryption: default to false, set to true to enable - must provide a key
+  * every: how often the send_gearman will send the passive check (default to 1.minute)
+
+add :notify_on => :unmonitored to make bluepill send notification when unmonitored
+
+Example:
+
+```
+require 'bluepill-gearman'
+Bluepill.application("test") do |app|
+  app.process("test") do |process|
+    process.start_command = "bundle exec ./test.rb"
+    process.pid_file = "/var/run/test.pid"
+    process.daemonize = true
+    process.checks :send_gearman, :gearman_server => 'my.gearman.server', :host => 'host_in_nagios', :service => 'passive check service name', :notify_on => :unmonitored, :every => 1.minute
+  end
+end
+```
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,14 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+require "rake/testtask"
+require "yard"
+
+Rake::TestTask.new do |t|
+  t.libs.push "lib"
+  t.test_files = FileList['spec/*_spec.rb']
+  t.verbose = true
+end
+
+YARD::Rake::YardocTask.new do |t|
+  t.files   = ['lib/**/*.rb']
+end

data/bluepill-gearman.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/bluepill-gearman/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Ami Mahloof"]
+  gem.email         = ["ami.mahloof@gmail.com"]
+  gem.description   = %q{send events to gearman when a bluepill process state changes}
+  gem.summary       = %q{send events to gearman via the send_gearman when a bluepill monitored process triggers a state change}
+  gem.homepage      = "http://github.com/innovia/bluepill-gearman"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.name          = "bluepill-gearman"
+  gem.require_paths = ["lib"]
+  gem.add_dependency "bluepill"
+  gem.add_dependency "gearman-ruby"
+  #gem.add_dependency "crypt"
+  gem.add_development_dependency "minitest"
+  gem.add_development_dependency "mocha"
+  gem.add_development_dependency "yard"
+  gem.add_development_dependency "redcarpet"
+  gem.version       = Bluepill::Gearman::VERSION
+end

data/lib/bluepill-gearman/version.rb

@@ -0,0 +1,5 @@
+module Bluepill
+  module Gearman
+    VERSION = "1.0.0"
+  end
+end

data/lib/bluepill-gearman.rb

@@ -0,0 +1,108 @@
+require "bluepill-gearman/version"
+require 'gearman'
+require "bluepill"
+require 'base64'
+require "openssl"
+require "digest"
+ 
+module Bluepill
+  module Gearman
+    class SendGearman < Bluepill::Trigger
+      <<-INFO
+        Called by bluepill when a "checks :send_gearman" is declared in pill file
+        @param [Bluepill::Process] process object from Bluepill see http://rdoc.info/github/arya/bluepill/master/Bluepill/Process
+        @param [Hash] options available options:
+          * gearman_server: the Gearman Server. mandatory
+          * gearman_port: the gearman server port or default to 4730
+          * host: the host defined in nagios to be hosting the service (default: hostname -f)
+          * service: the service declared in nagios (default: the bluepill process name)
+          * queue: default queue is 'check_results'
+          * key: provide a key for encryption (minimum 8 bytes)
+          * encryption: default to false set to true to enable
+          * every: how often the send_gearman will send the passive check
+
+          See checks https://github.com/arya/bluepill for the syntax to pass those options
+          encryption: https://gist.github.com/RiANOl/1077760
+      INFO
+
+      def initialize(process, options={})
+        @default_args = {
+          :gearman_job_server => ["#{options.delete(:gearman_server)}:#{options.delete(:gearman_port) || 4730}"],
+          :host => options.delete(:host) || `hostname -f`.chomp,
+          :service => options.delete(:service) || process.name,
+          :queue => options.delete(:queue) || 'check_results',
+          :key => options.delete(:key) || '',
+          :encryption => options.delete(:encryption) || false,
+          :every  => options.delete(:every) || 1.minute
+        }
+        super
+      end
+      
+      # Called by bluepill when process states changes. Notifies the nagios when:
+      # * the process goes to :unmonitored notifies warning
+      # * the process goes to :down notifies critical
+      # * the process goes to :up notifies ok
+      def notify(transition)
+        _return_code, _status = case transition.to_name
+        when :down
+          [2, "Bluepill reported process down at #{Time.now}"]
+        when :unmonitored
+          [1 , "Bluepill stopped monitoring at #{Time.now}"]
+        when :up
+          [0 , "Running"]
+        else
+          [nil, nil]
+        end
+        if _status and _return_code
+          _args = @default_args.merge({:status => _status, :return_code => _return_code})
+          send_gearman(_args)
+        end
+      end
+
+    protected
+      def aes256_encrypt(key, data)
+        key = null_padding(key)
+        aes = OpenSSL::Cipher.new('AES-256-ECB')
+        aes.encrypt
+        aes.key = key
+        aes.update(data) + aes.final
+      end
+
+      def null_padding(key)
+        padding = (32 - key.bytesize) if(key.kind_of?(String) && 32 != key.bytesize)
+        key += "\0" * padding
+      end
+
+      def send_gearman(args)
+        begin
+          client  = ::Gearman::Client.new(args[:gearman_job_server])
+          job = <<-EOT
+type=passive
+host_name=#{args[:host]}
+service_description=#{args[:service]}
+start_time=#{Time.now.to_i}.0
+finish_time=#{Time.now.to_i}.0
+latency=0.0
+return_code=#{args[:return_code]}
+output=#{args[:status]}
+EOT
+          if args[:encryption]
+            begin
+              job = aes256_encrypt(args[:key], job)
+            rescue Exception => e
+              logger.warn "unable to encrypt: #{e}"
+            end
+          end
+          encoded_job = Base64.encode64(job)
+          result = client.do_task(args[:queue], encoded_job) 
+
+          logger.info "Sent Job to Gearman Server #{result}"
+          logger.info "Next job status passive check: #{args[:every]}"
+          sleep(args[:every]) 
+        rescue Exception => e
+          logger.warn "Failed to send job to the Gearman Server: #{e}"
+        end
+      end
+    end
+  end
+end

data/spec/bluepill-gearman_spec.rb

@@ -0,0 +1,40 @@
+require 'minitest/spec'
+require 'test/unit'
+require 'mocha/test_unit'
+require 'minitest/autorun'
+require 'mocha'
+require './lib/bluepill-gearman'
+
+describe Bluepill::Gearman::SendGearman do
+  let(:process) { Minitest::Mock.new }
+  let(:notifier) {Bluepill::Gearman::SendGearman.new(process, {:gearman_server => 'remotehost', :host => 'localhost'})}
+
+  it "should create a default_args instance variable to store default connection parameters" do
+    process.expect(:name, 'my_process')
+    notifier.instance_variable_get(:@default_args).must_equal({:gearman_job_server => ['remotehost:4730'], :host => 'localhost', :service => 'my_process', :queue => 'check_results', :encryption => false, :key => '', :every => 1.minute})
+  end
+
+  it "should notify gearman_server of a critical error via send_gearman when a transition to down occurs" do
+    process.expect(:name, 'my_process')
+    transition = Minitest::Mock.new
+    transition.expect(:to_name,:down)
+    notifier.expects(:send_gearman).with({:gearman_server => ['remotehost:4730'], :host => 'localhost', :service => 'my_process', :return_code => 2, :status => "Bluepill reported process down at #{Time.now}"})
+    notifier.notify(transition)
+  end
+
+  # it "should notify gearman_server of a warning error via send_gearman when a transition to unmonitored occurs" do
+  #   process.expect(:name, 'my_process')
+  #   transition = Minitest::Mock.new
+  #   transition.expect(:to_name,:unmonitored)
+  #   notifier.expects(:send_gearman).with({:gearman_server => ['remotehost:4730'], :host => 'localhost', :service => 'my_process', :return_code => 1, :status => "Bluepill stopped monitoring at #{Time.now}"})
+  #   notifier.notify(transition)
+  # end
+
+  # it "should notify gearman_server that everything is ok via send_gearman when a transition to up occurs" do
+  #   process.expect(:name, 'my_process')
+  #   transition = Minitest::Mock.new
+  #   transition.expect(:to_name,:up)
+  #   notifier.expects(:send_gearman).with({:gearman_server => ['remotehost:4730'], :host => 'localhost', :service => 'my_process', :return_code => 0, :status => "Running"})
+  #   notifier.notify(transition)
+  # end
+end

metadata

@@ -0,0 +1,154 @@
+--- !ruby/object:Gem::Specification
+name: bluepill-gearman
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Ami Mahloof
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-02-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bluepill
+  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: gearman-ruby
+  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: minitest
+  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: mocha
+  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: yard
+  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: redcarpet
+  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'
+description: send events to gearman when a bluepill process state changes
+email:
+- ami.mahloof@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rbenv-version
+- Changelog.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bluepill-gearman.gemspec
+- lib/bluepill-gearman.rb
+- lib/bluepill-gearman/version.rb
+- spec/bluepill-gearman_spec.rb
+homepage: http://github.com/innovia/bluepill-gearman
+licenses: []
+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.25
+signing_key: 
+specification_version: 3
+summary: send events to gearman via the send_gearman when a bluepill monitored process
+  triggers a state change
+test_files: []
+has_rdoc: