nsca-client 0.1.0

data/.gitignore

@@ -0,0 +1 @@
+Gemfile.lock

data/.rspec

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

data/Gemfile

@@ -0,0 +1,3 @@
+source :rubygems
+
+gemspec

data/README.md

@@ -0,0 +1,8 @@
+NSCA Client
+===========
+
+NSCA is a Linux/Unix daemon allows you to integrate passive alerts and checks
+from remote machines and applications with Nagios. Useful for processing
+security alerts, as well as redundant and distributed Nagios setups.
+
+**This client allows you to send easily passive alerts and checks.**

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/lib/nsca/client.rb

@@ -0,0 +1,46 @@
+require 'nsca/client/host'
+require 'nsca/client/message'
+require 'nsca/client/notifier'
+require 'nsca/client/remote_server'
+require 'nsca/client/service'
+require 'nsca/client/version'
+
+module NSCA
+  module Client
+    class << self
+      def servers
+        @servers ||= []
+      end
+
+      def ok(service, message = 'OK')
+        status = false
+        servers.each do |server|
+          message = Message.new(:ok, message, service, server)
+          notifier = Notifier.new(message)
+          status = true if notifier.send_nsca
+        end
+        status
+      end
+
+      def warning(service, message = 'WARNING')
+        status = false
+        servers.each do |server|
+          message = Message.new(:warn, message, service, server)
+          notifier = Notifier.new(message)
+          status = true if notifier.send_nsca
+        end
+        status
+      end
+
+      def critical(service, message = 'CRITICAL')
+        status = false
+        servers.each do |server|
+          message = Message.new(:critical, message, service, server)
+          notifier = Notifier.new(message)
+          status = true if notifier.send_nsca
+        end
+        status
+      end
+    end
+  end
+end

data/lib/nsca/client/host.rb

@@ -0,0 +1,17 @@
+require 'socket'
+
+module NSCA
+  module Client
+    class Host
+      attr_reader :hostname
+
+      def initialize(options)
+        @hostname = options[:hostname]
+      end
+
+      def self.current
+        Host.new(:hostname => Socket.gethostname)
+      end
+    end
+  end
+end

data/lib/nsca/client/message.rb

@@ -0,0 +1,27 @@
+module NSCA
+  module Client
+    class Message
+      CODE = { :ok => 0, :warn => 1, :critical => 2 }
+
+      attr_reader :return_code
+
+      def initialize(alert, status, service, remote_server)
+        @return_code = CODE[alert]
+        @status = status
+        @service = service
+        @remote_server = remote_server
+      end
+
+      def to_h
+        {
+          :nscahost    => @remote_server.host,
+          :port        => @remote_server.port,
+          :hostname    => @service.host.hostname,
+          :service     => @service.name,
+          :return_code => @return_code,
+          :status      => @status
+        }
+      end
+    end
+  end
+end

data/lib/nsca/client/notifier.rb

@@ -0,0 +1,17 @@
+require 'send_nsca'
+
+module NSCA
+  module Client
+    class Notifier
+      def initialize(message)
+        @message = message
+      end
+
+      def send_nsca
+        connection = SendNsca::NscaConnection.new(@message.to_h)
+        connection.send_nsca
+        true
+      end
+    end
+  end
+end

data/lib/nsca/client/remote_server.rb

@@ -0,0 +1,12 @@
+module NSCA
+  module Client
+    class RemoteServer
+      attr_reader :host, :port
+
+      def initialize(options)
+        @host = options[:host]
+        @port = options[:port] || 5667
+      end
+    end
+  end
+end

data/lib/nsca/client/service.rb

@@ -0,0 +1,12 @@
+module NSCA
+  module Client
+    class Service
+      attr_accessor :name, :host
+
+      def initialize(options)
+        @name = options[:name]
+        @host = options[:host] || Host.current
+      end
+    end
+  end
+end

data/lib/nsca/client/version.rb

@@ -0,0 +1,5 @@
+module NSCA
+  module Client
+    VERSION = '0.1.0'
+  end
+end

data/nsca-client.gemspec

@@ -0,0 +1,22 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "nsca/client/version"
+
+Gem::Specification.new do |gem|
+  gem.authors       = `git log --raw | grep Author: | awk -F ': | <|>' '{ print $2 }' | sort | uniq`.split("\n")
+  gem.email         = `git log --raw | grep Author: | awk -F ': | <|>' '{ print $3 }' | sort | uniq`.split("\n")
+  gem.description   = %q{Send passive notifications to Nagios Service Check Acceptor (NSCA).}
+  gem.summary       = %q{NSCA Client}
+  gem.homepage      = "https://github.com/felipecvo/nsca-client"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^spec/})
+  gem.name          = "nsca-client"
+  gem.require_paths = ["lib"]
+  gem.version       = NSCA::Client::VERSION
+
+  gem.add_dependency "send_nsca"
+
+  gem.add_development_dependency "rspec"
+end

data/spec/nsca/client/host_spec.rb

@@ -0,0 +1,12 @@
+require 'spec_helper'
+
+describe NSCA::Client::Host do
+  subject { described_class.new(:hostname => 'dummy') }
+  its(:hostname) { should eq 'dummy' }
+
+  context "current machine" do
+    before { Socket.stub(:gethostname).and_return('dummy-client-machine') }
+    subject { described_class.current }
+    its(:hostname) { should eq 'dummy-client-machine' }
+  end
+end

data/spec/nsca/client/message_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe NSCA::Client::Message do
+  let(:server) { NSCA::Client::RemoteServer.new(:host => '172.0.0.1') }
+  let(:host) { NSCA::Client::Host.new(:hostname => 'dummy') }
+  let(:service) { NSCA::Client::Service.new(:name => 'TestMessage', :host => host) }
+
+  subject { described_class.new(:ok, 'OK', service, server).to_h }
+
+  its([:nscahost]) { should eq '172.0.0.1' }
+  its([:port]) { should eq 5667 }
+  its([:hostname]) { should eq 'dummy' }
+  its([:service]) { should eq 'TestMessage' }
+  its([:return_code]) { should eq 0 }
+  its([:status]) { should eq 'OK' }
+
+  context "ok message" do
+    subject { described_class.new(:ok, 'OK', service, server) }
+    its(:return_code) { should eq 0 }
+  end
+
+  context "warn message" do
+    subject { described_class.new(:warn, 'WARN', service, server) }
+    its(:return_code) { should eq 1 }
+  end
+
+  context "critical message" do
+    subject { described_class.new(:critical, 'CRITICAL', service, server) }
+    its(:return_code) { should eq 2 }
+  end
+end

data/spec/nsca/client/notifier_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+describe NSCA::Client::Notifier do
+  let(:server) { NSCA::Client::RemoteServer.new(:host => '172.0.0.1') }
+  let(:host) { NSCA::Client::Host.new(:hostname => 'dummy') }
+  let(:service) { NSCA::Client::Service.new(:name => 'TestMessage', :host => host) }
+  let(:message) { NSCA::Client::Message.new(:ok, 'OK', service, server) }
+
+  context "send message successfully" do
+    before do
+      SendNsca::NscaConnection.any_instance.should_receive(:send_nsca)
+    end
+
+    let(:notifier) { NSCA::Client::Notifier.new(message) }
+
+    subject { notifier.send_nsca }
+
+    it { should be_true }
+  end
+end

data/spec/nsca/client/remote_server_spec.rb

@@ -0,0 +1,12 @@
+require 'spec_helper'
+
+describe NSCA::Client::RemoteServer do
+  subject { described_class.new(:host => '172.0.0.1') }
+  its(:host) { should eq '172.0.0.1' }
+  its(:port) { should eq 5667 }
+
+  context "custom port" do
+    subject { described_class.new(:port => 12345) }
+    its(:port) { should eq 12345 }
+  end
+end

data/spec/nsca/client/service_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+
+describe NSCA::Client::Service do
+  let(:host) { NSCA::Client::Host.new(:hostname => 'asdf') }
+  subject { described_class.new(:name => 'TestMessage', :host => host) }
+
+  its(:name) { should eq 'TestMessage' }
+  its(:host) { should eq host }
+
+  context "default host to current machine" do
+    subject { described_class.new(:name => 'SimpleMessage') }
+
+    its(:name) { should eq 'SimpleMessage' }
+    its(:host) { should be_a NSCA::Client::Host }
+  end
+end

data/spec/nsca/client_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe NSCA::Client do
+  let(:service) { NSCA::Client::Service.new(:name => 'TestMessage') }
+
+  before(:all) do
+    NSCA::Client.servers << NSCA::Client::RemoteServer.new(:host => '172.0.0.1')
+  end
+
+  before(:each) do
+    SendNsca::NscaConnection.any_instance.should_receive(:send_nsca)
+  end
+
+  context "normal service operation" do
+    it "should notify" do
+      NSCA::Client.ok(service).should be_true
+    end
+  end
+
+  context "unstable service operation" do
+    it "should notify" do
+      NSCA::Client.warning(service).should be_true
+    end
+  end
+
+  context "critical service state" do
+    it "should notify" do
+      NSCA::Client.critical(service).should be_true
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+require 'nsca/client'
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  config.order = 'random'
+end

metadata

@@ -0,0 +1,104 @@
+--- !ruby/object:Gem::Specification
+name: nsca-client
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Felipe Oliveira
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: send_nsca
+  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: rspec
+  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 passive notifications to Nagios Service Check Acceptor (NSCA).
+email:
+- felipe.oliveira@abril.com.br
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- README.md
+- Rakefile
+- lib/nsca/client.rb
+- lib/nsca/client/host.rb
+- lib/nsca/client/message.rb
+- lib/nsca/client/notifier.rb
+- lib/nsca/client/remote_server.rb
+- lib/nsca/client/service.rb
+- lib/nsca/client/version.rb
+- nsca-client.gemspec
+- spec/nsca/client/host_spec.rb
+- spec/nsca/client/message_spec.rb
+- spec/nsca/client/notifier_spec.rb
+- spec/nsca/client/remote_server_spec.rb
+- spec/nsca/client/service_spec.rb
+- spec/nsca/client_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/felipecvo/nsca-client
+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.23
+signing_key: 
+specification_version: 3
+summary: NSCA Client
+test_files:
+- spec/nsca/client/host_spec.rb
+- spec/nsca/client/message_spec.rb
+- spec/nsca/client/notifier_spec.rb
+- spec/nsca/client/remote_server_spec.rb
+- spec/nsca/client/service_spec.rb
+- spec/nsca/client_spec.rb
+- spec/spec_helper.rb