pandur 0.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0a65c44db60d3634ce6a602513da833ef62b4d85
+  data.tar.gz: 3b5380493d3c5fd6c2b119fe7854c4928e299e62
+SHA512:
+  metadata.gz: 668c7e031650ef7cee1b87915c991e57075ce7aa623796f49e7434b407b1eb14c6ad418ef8f47d2448df054833617a7d9c256aa61d074873da0fe7d4418ab4d4
+  data.tar.gz: bcd8baf4122461d2fcae872230fcd7827413705a9bed434f1b2d027669cd768798958067c341c69e324175e868aba87b316507bf4a2dc72b6e30d2555155615d

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2013 Rainer Jung <Rainer.Jung@gmail.com>
+
+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,33 @@
+pandur - AdHoc Monitoring
+=========================
+
+This gem is yet alpha, so please don't expect to much.
+
+Usage
+-----
+
+To use run
+
+    pandur [status]  # query status
+    pandur init      # create configuration (not working yet)
+
+To install run
+
+    gem install pandur
+
+Configuration
+-------------
+
+You need to create a configuration (a yaml-file) of all hosts to connect to, and
+wich processes are meant to monitor. Here's a simple example:
+
+    ---
+    hosts:
+    - name: web
+      username: "www-data"
+      check:
+      - name: "Elastic Search"
+        pid_file: /var/run/elasticsearch.pid
+      - name: Memcached
+        pid_file: /var/run/memcached.pid
+

data/Rakefile

@@ -0,0 +1,9 @@
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.rspec_opts = ['-fd', '--color']
+end
+Bundler::GemHelper.install_tasks
+
+# Default task runs specs
+task :default => :spec

data/bin/pandur

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+require 'pandur'
+Pandur.run

data/lib/pandur/check.rb

@@ -0,0 +1,57 @@
+module Pandur
+  class Check
+    include Pandur::Config
+
+    def initialize(target)
+      @config = target
+    end
+
+    def check(ssh)
+      logger.debug("Checking #{@config['name']}")
+      if @config['pid_file']
+        print "Checking #{@config['name']}: "
+        escaped_pid_file = @config['pid_file'].gsub('\'', '\\\'')
+        if(ssh_exec!(ssh, "test -r '#{escaped_pid_file}' && test -n '`ps -ef | grep -v grep | grep \`cat '#{escaped_pid_file}'\``'")[2] > 0)
+          puts "FAIL"
+        else
+          puts "OK"
+        end
+      else
+        logger.debug("cannot check #{@config.inspect}")
+      end
+    end
+
+    private
+
+    def ssh_exec!(ssh, command)
+      stdout_data = ""
+      stderr_data = ""
+      exit_code = nil
+      exit_signal = nil
+      ssh.open_channel do |channel|
+        channel.exec(command) do |ch, success|
+          unless success
+            abort "FAILED: couldn't execute command (ssh.channel.exec)"
+          end
+          channel.on_data do |ch,data|
+            stdout_data+=data
+          end
+
+          channel.on_extended_data do |ch,type,data|
+            stderr_data+=data
+          end
+
+          channel.on_request("exit-status") do |ch,data|
+            exit_code = data.read_long
+          end
+
+          channel.on_request("exit-signal") do |ch, data|
+            exit_signal = data.read_long
+          end
+        end
+      end
+      ssh.loop
+      [stdout_data, stderr_data, exit_code, exit_signal]
+    end
+  end
+end

data/lib/pandur/config.rb

@@ -0,0 +1,24 @@
+# To access configuration (and logging), just include this module to your class,
+# and you can directly access all configuration and the logging.
+#
+#   class ExampleClass
+#     include Pandur::Config
+#
+#     def some_method
+#       logger.debug(config('some_config'))
+#     end
+#   end
+
+module Pandur
+  module Config
+    @config = {}
+
+    def logger
+      Pandur.logger
+    end
+
+    def config(conf)
+      Pandur.config(conf)
+    end
+  end
+end

data/lib/pandur/host.rb

@@ -0,0 +1,23 @@
+require 'net/ssh'
+require 'pandur/check'
+
+module Pandur
+  class Host
+    include Pandur::Config
+
+    def initialize(target)
+      @config = target
+    end
+
+    def check
+      logger.debug("Connecting to #{@config['username']}@#{@config['hostname']}")
+      Net::SSH.start(@config['hostname'], @config['username'],
+                     :password => @config['password']) do |ssh|
+        @config['check'].each do |check|
+          Pandur::Check.new(check).check(ssh)
+        end
+      end
+    end
+
+  end
+end

data/lib/pandur/version.rb

@@ -0,0 +1,3 @@
+module Pandur
+  VERSION = '0.0.0'
+end

data/lib/pandur.rb

@@ -0,0 +1,50 @@
+require 'pandur/version'
+require 'pandur/config'
+require 'pandur/host'
+require 'net/ssh/errors'
+require 'logger'
+require 'yaml'
+
+module Pandur
+
+  class << self
+
+    def run(conf = 'pandur.yaml')
+      logger.debug("#{name} running ..")
+      load_config(conf)
+      config('hosts').each do |host|
+        check(host)
+      end
+      logger.debug("#{name} .. finished")
+    end
+
+    def check(target)
+      Pandur::Host.new(target).check
+    rescue Net::SSH::AuthenticationFailed
+      puts "Failed to connect: #{$!.message}"
+    end
+
+    def load_config(file)
+      logger.debug("Loading configuration from #{file.to_s}")
+      @@config = YAML::load_file(file)
+    end
+
+    def config(*params)
+      @@config ||= {}
+      case params.length()
+      when 0
+        @@config
+      when 1
+        @@config[params.first]
+      else
+        @@config[params[0]] = params[1]
+      end
+    end
+
+    def logger
+      @@logger ||= Logger.new(STDERR)
+    end
+
+  end
+
+end

data/pandur.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path('../lib', __FILE__)
+require 'pandur/version'
+
+Gem::Specification.new do |s|
+  s.name          = 'pandur'
+  s.version       = Pandur::VERSION
+  s.date          = '2013-04-03'
+  s.license       = 'MIT'
+  s.summary       = 'AdHoc monitoring'
+  s.description   = 'Check your services when you need to'
+  s.authors       = ['Rainer Jung <Rainer.Jung@gmail.com>']
+  s.email         = 'rj@pandur.org'
+  s.executables   << 'pandur'
+  s.bindir        = 'bin'
+  s.homepage      = 'http://github.com/rynr/pandur'
+  s.post_install_message =
+                    'Pandur yet comes without a config-generation'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- spec/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
+  s.extra_rdoc_files = 'README.md'
+
+  s.add_runtime_dependency('net-ssh')
+  s.add_development_dependency('rspec')
+end

data/spec/config.yaml

@@ -0,0 +1,9 @@
+---
+config_to_be_tested_by_pandur_spec.rb: success
+
+hosts:
+- hostname: localhost
+  username: rjung
+  check:
+  - name: Memcached
+    pid_file: /var/run/memcached.pid

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require File.join(File.dirname(__FILE__), '..', 'lib', 'pandur')

data/spec/units/pandur_config_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe Pandur::Config do
+
+  class PandurLoggerRspecTest; include Pandur::Config; end
+
+  before(:each) do
+    @sut = PandurLoggerRspecTest.new
+  end
+
+  it 'uses Pandur.logger' do
+    Pandur.should_receive(:logger)
+    @sut.logger
+  end
+
+  it 'uses Pandur.config' do
+    Pandur.should_receive(:config).with('conf-name')
+    @sut.config('conf-name')
+  end
+
+  it 'gets config' do
+    Pandur.load_config(File.join(File.dirname(__FILE__), '..', 'config.yaml'))
+    @sut.config('config_to_be_tested_by_pandur_spec.rb').should eql('success')
+  end
+
+end

data/spec/units/pandur_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+
+describe Pandur do
+
+  it 'can get logger' do
+    Pandur.logger.should_not be(:nil)
+  end
+
+  it 'can load config from file' do
+    Pandur.load_config(File.join(File.dirname(__FILE__), '..', 'config.yaml'))
+    Pandur.config('config_to_be_tested_by_pandur_spec.rb').should eql('success')
+  end
+
+end

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification
+name: pandur
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+platform: ruby
+authors:
+- Rainer Jung <Rainer.Jung@gmail.com>
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: net-ssh
+  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: rspec
+  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: Check your services when you need to
+email: rj@pandur.org
+executables:
+- pandur
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/pandur
+- lib/pandur.rb
+- lib/pandur/check.rb
+- lib/pandur/config.rb
+- lib/pandur/host.rb
+- lib/pandur/version.rb
+- pandur.gemspec
+- spec/config.yaml
+- spec/spec_helper.rb
+- spec/units/pandur_config_spec.rb
+- spec/units/pandur_spec.rb
+homepage: http://github.com/rynr/pandur
+licenses:
+- MIT
+metadata: {}
+post_install_message: Pandur yet comes without a config-generation
+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.0.3
+signing_key: 
+specification_version: 4
+summary: AdHoc monitoring
+test_files:
+- spec/config.yaml
+- spec/spec_helper.rb
+- spec/units/pandur_config_spec.rb
+- spec/units/pandur_spec.rb