nines 1.0.0

data/.gitignore

@@ -0,0 +1,10 @@
+# log and pid files
+log/nines.log
+tmp/nines.pid
+
+# config files
+nines.rb
+nines.yml
+
+# built gem
+nines-*.gem

data/.rvmrc

@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+
+ruby_string="ruby-1.9.3-p327"
+gemset_name="nines"
+
+alias rails='bundle exec rails'
+
+if rvm list strings | grep -q "${ruby_string}" ; then
+
+  # Load or create the specified environment
+  if [[ -d "${rvm_path:-$HOME/.rvm}/environments" \
+    && -s "${rvm_path:-$HOME/.rvm}/environments/${ruby_string}@${gemset_name}" ]] ; then
+    \. "${rvm_path:-$HOME/.rvm}/environments/${ruby_string}@${gemset_name}"
+  else
+    rvm --create  "${ruby_string}@${gemset_name}"
+  fi
+
+#  (
+#    # Ensure that Bundler is installed, install it if it is not.
+#    if ! command -v bundle ; then
+#      gem install bundler
+#    fi
+#
+#    # Bundle while reducing excess noise.
+#    bundle | grep -v 'Using' | grep -v 'complete' | sed '/^$/d'
+#  )&
+
+else
+
+  # Notify the user to install the desired interpreter before proceeding.
+  echo "${ruby_string} was not found, please run 'rvm install ${ruby_string}' and then cd back into the project directory."
+
+fi

data/MIT-LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Aaron Namba <aaron@biggerbird.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.rdoc

@@ -0,0 +1,24 @@
+=nines
+
+Nines is a simple server monitoring tool written in Ruby. It reads in hand-coded YAML config files (see config.yml.sample). Rename to config.yml and edit as needed before first run.
+
+When run, it forks into the background and runs in a continuous loop. If there are bugs in the code (likely) it may die, so keep it running with monit, init, etc.
+
+=Usage
+
+git clone git://github.com/anamba/nines.git && cd nines && bundle install && bundle exec ./nines
+To stop: bundle exec ./nines stop
+
+=Dependencies
+
+Developed and tested with MRI ruby 1.9.3.
+
+Dependencies:
+* trollop (commandline options)
+* net-ping (http/ping testing)
+* dnsruby (dns resolution)
+* mail (email)
+
+=License & Copyright
+
+Distributed under MIT license. Copyright (c) 2012 Aaron Namba <aaron@biggerbird.com>

data/bin/nines

@@ -0,0 +1,61 @@
+#!/usr/bin/env ruby
+
+require 'trollop'
+require 'nines/version'
+
+opts = Trollop::options do
+  version "nines #{Nines::VERSION} (c) Aaron Namba"
+  banner "nines #{Nines::VERSION} (c) Aaron Namba\nNote: Command line parameters override config file values."
+  
+  opt 'config-file', "Path to YAML configuration file", :short => '-f', :default => 'nines.yml'
+  opt 'verbose', "Enable detailed logging", :type => :boolean
+  opt 'debug', "Run each check once, then exit", :type => :boolean
+  
+  stop_on [ 'start', 'stop' ]
+end
+
+# absolutize config file path
+opts['config-file'] = opts['config-file'] =~ /^\// ? opts['config-file'] : File.expand_path(opts['config-file'], Dir.pwd)
+
+unless File.exists?(opts['config-file'])
+  puts "Config file #{opts['config-file']} not found (or not accessible)"
+  exit 1
+end
+
+# args seem okay, load up the app
+require 'nines'
+
+# instantiate Nines::App using config file
+app = Nines::App.new(File.expand_path(opts['config-file']))
+Nines::App.debug ||= opts['debug']
+Nines::App.verbose ||= opts['verbose']
+
+unless Nines::App.debug
+  unless app.logfile_writable 
+    puts "Couldn't open #{app.logfile} for logging"
+    exit 1
+  end
+  unless app.pidfile_writable
+    puts "Couldn't write pid to #{app.pidfile}"
+    exit 1
+  end
+end
+
+# process subcommands
+cmd = ARGV.shift
+case cmd
+when 'start'
+  cmd_opts = Trollop.options do
+  end
+  
+  app.start(cmd_opts)
+  
+when 'stop'
+  cmd_opts = Trollop.options do
+  end
+  
+  app.stop(cmd_opts)
+  
+else
+  app.start
+end

data/doc/logrotate.conf

@@ -0,0 +1,8 @@
+# example logrotate config
+/var/log/nines.log {
+  daily
+  rotate 30
+  copytruncate
+  compress
+  dateext
+}

data/install.rb

@@ -0,0 +1,90 @@
+require 'rbconfig'
+require 'find'
+require 'fileutils'
+
+include RbConfig
+
+$ruby = CONFIG['ruby_install_name']
+
+##
+# Install a binary file. We patch in on the way through to
+# insert a #! line. If this is a Unix install, we name
+# the command (for example) 'rake' and let the shebang line
+# handle running it. Under windows, we add a '.rb' extension
+# and let file associations to their stuff
+#
+
+def installBIN(from, opfile)
+
+  tmp_dir = nil
+  for t in [".", "/tmp", "c:/temp", $bindir]
+    stat = File.stat(t) rescue next
+    if stat.directory? and stat.writable?
+      tmp_dir = t
+      break
+    end
+  end
+
+  fail "Cannot find a temporary directory" unless tmp_dir
+  tmp_file = File.join(tmp_dir, "_tmp")
+
+  File.open(from) do |ip|
+    File.open(tmp_file, "w") do |op|
+      ruby = File.join($realbindir, $ruby)
+      op.puts "#!#{ruby} -w"
+      op.write ip.read
+    end
+  end
+
+  opfile += ".rb" if CONFIG["target_os"] =~ /mswin/i
+  FileUtils.install(tmp_file, File.join($bindir, opfile),
+    {:mode => 0755, :verbose => true})
+  File.unlink(tmp_file)
+end
+
+$sitedir = CONFIG["sitelibdir"]
+unless $sitedir
+  version = CONFIG["MAJOR"]+"."+CONFIG["MINOR"]
+  $libdir = File.join(CONFIG["libdir"], "ruby", version)
+  $sitedir = $:.find {|x| x =~ /site_ruby/}
+  if !$sitedir
+    $sitedir = File.join($libdir, "site_ruby")
+  elsif $sitedir !~ Regexp.quote(version)
+    $sitedir = File.join($sitedir, version)
+  end
+end
+
+$bindir =  CONFIG["bindir"]
+
+$realbindir = $bindir
+
+bindir = CONFIG["bindir"]
+if (destdir = ENV['DESTDIR'])
+  $bindir  = destdir + $bindir
+  $sitedir = destdir + $sitedir
+
+  FileUtils.mkdir_p($bindir)
+  FileUtils.mkdir_p($sitedir)
+end
+
+rake_dest = File.join($sitedir, "rake")
+FileUtils.mkdir_p(rake_dest, {:verbose => true})
+File.chmod(0755, rake_dest)
+
+# The library files
+
+files = Dir.chdir('lib') { Dir['**/*.rb'].sort }
+
+for fn in files
+  fn_dir = File.dirname(fn)
+  target_dir = File.join($sitedir, fn_dir)
+  if ! File.exist?(target_dir)
+    FileUtils.mkdir_p(target_dir)
+  end
+  FileUtils.install(File.join('lib', fn), File.join($sitedir, fn),
+    {:mode => 0644, :verbose => true})
+end
+
+# and the executable
+
+installBIN("bin/nines", "nines")

data/lib/nines/app.rb

@@ -0,0 +1,194 @@
+require 'yaml'
+require 'erb'
+require 'dnsruby'
+require 'mail'
+
+module Nines
+  class App
+    class << self
+      attr_accessor :root, :config, :continue,
+                    :debug, :verbose, :logfile, :pidfile, :logger, :notifier,
+                    :email_from, :email_subject_prefix
+    end
+    
+    def initialize(config_file)
+      self.class.root = File.expand_path('../../../', __FILE__)
+      
+      # load config files
+      case File.extname(config_file)
+        when '.yml' then self.class.config = YAML.load(ERB.new(File.read(config_file)).result)
+        when '.rb'  then require config_file
+      end
+      self.class.config = stringify_keys_and_symbols(self.class.config)
+      
+      # set main parameters
+      self.class.debug      = config['debug']
+      self.class.verbose    = config['verbose']
+      
+      self.class.logfile    = config['logfile'] || 'nines.log'
+      self.class.pidfile    = config['pidfile'] || 'nines.pid'
+      self.class.email_from = config['email_from'] || 'Nines Notifier <no-reply@example.com>'
+      self.class.email_subject_prefix = config['email_subject_prefix'] || ''
+    end
+    
+    # shortcuts
+    def config    ; self.class.config   ; end
+    def logfile   ; self.class.logfile  ; end
+    def pidfile   ; self.class.pidfile  ; end
+    def debug     ; self.class.debug    ; end
+    def logger    ; self.class.logger   ; end
+    
+    def logfile_writable
+      begin
+        File.open(logfile, 'a') { }
+        true
+      rescue Exception => e
+        puts "Exception: #{e}"
+        false
+      end
+    end
+    
+    def pidfile_writable
+      begin
+        File.open(pidfile, 'a') { }
+        true
+      rescue Exception => e
+        puts "Exception: #{e}"
+        false
+      end
+    end
+    
+    # make sure you're not using OpenDNS or something else that resolves invalid names
+    def check_hostnames
+      all_good = true
+      
+      @check_groups.each do |group|
+        group.checks.each do |check|
+          unless check.hostname && Dnsruby::Resolv.getaddress(check.hostname)
+            puts "Error: check #{check.name} has invalid hostname '#{check.hostname}'"
+            all_good = false
+          end
+        end
+      end
+      
+      all_good
+    end
+    
+    def configure_smtp
+      if config['smtp'].is_a?(Hash)
+        Mail.defaults do
+          delivery_method :smtp, { 
+            :address => Nines::App.config['smtp']['address'] || 'localhost',
+            :port => Nines::App.config['smtp']['port'] || 25,
+            :domain => Nines::App.config['smtp']['domain'],
+            :user_name => Nines::App.config['smtp']['user_name'],
+            :password => Nines::App.config['smtp']['password'],
+            :authentication => (Nines::App.config['smtp']['authentication'] || 'plain').to_sym,
+            :enable_starttls_auto => Nines::App.config['smtp']['enable_starttls_auto'],
+            :tls => Nines::App.config['smtp']['tls'],
+          }
+        end
+      end
+    end
+    
+    def stringify_keys_and_symbols(obj)
+      case obj.class.to_s
+      when 'Array'
+        obj.map! { |el| stringify_keys_and_symbols(el) }
+      when 'Hash'
+        obj.stringify_keys!
+        obj.each { |k,v| obj[k] = stringify_keys_and_symbols(v) }
+      when 'Symbol'
+        obj = obj.to_s
+      end
+      
+      obj
+    end
+    
+    def start(options = {})
+      # set up logger
+      self.class.logger = Logger.new(debug ? STDOUT : File.open(logfile, 'a'))
+      logger.sync = 1  # makes it possible to tail the logfile
+      
+      # use it
+      logger.puts "[#{Time.now}] - nines starting"
+      
+      # set up notifier
+      configure_smtp
+      self.class.notifier = Notifier.new(config['contacts'])
+      
+      # set up check_groups (uses logger and notifier)
+      if !config['check_groups'].is_a?(Array) || config['check_groups'].empty?
+        raise Exception.new("No check groups configured, nothing to do.")
+      end
+      
+      @check_groups = []
+      config['check_groups'].each do |options|
+        @check_groups << CheckGroup.new(options)
+      end
+      
+      # TODO: this is a little awkwardly placed, but can fix later
+      unless check_hostnames
+        puts "Invalid hostnames found in config file"
+        exit 1
+      end
+      
+      # fork and detach
+      if pid = fork
+        File.open(pidfile, 'w') { |f| f.print pid }
+        puts "Background process started with pid #{pid} (end it using `#{$0} stop`)"
+        puts "Debug mode enabled, background process will log to STDOUT and exit after running each check once." if debug
+        exit 0
+      end
+      
+      #
+      # rest of this method runs as background process
+      #
+      
+      # trap signals before spawning threads
+      self.class.continue = true
+      trap("INT") { Nines::App.continue = false ; puts "Caught SIGINT, will exit after current checks complete or time out." }
+      trap("TERM") { Nines::App.continue = false ; puts "Caught SIGTERM, will exit after current checks complete or time out." }
+      
+      # iterate through config, spawning check threads as we go
+      @threads = []
+      
+      @check_groups.each do |group|
+        group.checks.each do |check|
+          @threads << Thread.new(Thread.current) { |parent|
+            begin
+              check.run
+            rescue Exception => e
+              parent.raise e
+            end
+          }
+        end
+      end
+      
+      @threads.each { |t| t.join if t.alive? }
+      
+      logger.puts "[#{Time.now}] - nines finished"
+      logger.close
+      
+      puts "Background process finished"
+    end
+    
+    def stop(options = {})
+      begin
+        pid = File.read(self.class.pidfile).to_i
+      rescue Errno::ENOENT => e
+        STDERR.puts "Couldn't open pid file #{self.class.pidfile}, please check your config."
+        exit 1
+      end
+      
+      begin
+        Process.kill "INT", pid
+        exit 0
+      rescue Errno::ESRCH => e
+        STDERR.puts "Couldn't kill process with pid #{pid}. Are you sure it's running?"
+        exit 1
+      end
+    end
+    
+  end
+end

data/lib/nines/check.rb

@@ -0,0 +1,67 @@
+module Nines
+  class Check
+    attr_accessor :group, :name, :hostname, :address, :timeout, :port, :interval, :logger, :notifier, :up, :since, :cycles
+    
+    def initialize(group, options)
+      @group = group
+      @hostname = options['hostname']
+      @name = options['name'] || @hostname
+      @timeout = options['timeout_sec'] || 10
+      @port = options['port']
+      @interval = options['interval_sec'] || 60
+      
+      @logger = Nines::App.logger || STDOUT
+      @notifier = Nines::App.notifier
+      
+      @times_notified = {}
+      @up = true
+      @since = Time.now.utc
+      @cycles = 0
+    end
+    
+    def log_status(up, description)
+      if up
+        logger.puts "[#{Time.now}] - #{name} - Check passed: #{description}"
+        
+        case @up
+        when true
+          @cycles += 1
+        when false
+          @up = true
+          @since = Time.now.utc
+          @cycles = 0
+          
+          # back up notification
+          if notifier
+            @times_notified.keys.each do |contact_name|
+              logger.puts "[#{Time.now}] - #{name} - UP again, notifying contact '#{contact_name}'"
+              notifier.notify!(contact_name, self)
+            end
+            @times_notified = {}
+          end
+        end
+      else
+        logger.puts "[#{Time.now}] - #{name} - Check FAILED: #{description}"
+        
+        case @up
+        when false
+          @cycles += 1
+        when true
+          @up = false
+          @since = Time.now.utc
+          @cycles = 0
+        end
+        
+        if notifier && to_notify = group.contacts_to_notify(@cycles, @times_notified)
+          to_notify.each do |contact_name|
+            logger.puts "[#{Time.now}] - #{name} - Notifying contact '#{contact_name}'"
+            notifier.notify!(contact_name, self)
+            @times_notified[contact_name] ||= 0
+            @times_notified[contact_name] += 1
+          end
+        end
+      end
+    end
+    
+  end
+end

data/lib/nines/check_group.rb

@@ -0,0 +1,58 @@
+module Nines
+  class CheckGroup
+    attr_accessor :contacts, :checks
+    
+    def initialize(options = {})
+      options.stringify_keys!
+      @name = options['name']
+      @description = options['description']
+      
+      parameters = options['parameters'] || {}
+      parameters.stringify_keys!
+      @check_type = parameters.delete('type')
+      
+      @contacts = []
+      notify = options['notify'] || []
+      notify.each do |contact|
+        contact.stringify_keys!
+        @contacts << {
+          'name'  => contact['contact'],
+          'after' => contact['after'] || 2,
+          'every' => contact['every'] || 5,
+          'upto'  => contact['upto'] || 5
+        }
+      end
+      
+      @checks = []
+      checks = options['checks'] || []
+      checks.each do |check|
+        check = { hostname: check } unless check.is_a?(Hash)
+        check.stringify_keys!
+        case @check_type
+        when 'http'
+          @checks << HttpCheck.new(self, parameters.merge(check))
+        when 'ping'
+          @checks << PingCheck.new(self, parameters.merge(check))
+        else
+          raise Exception.new("Unknown check type: #{@check_type} (supported values: http, ping)")
+        end
+      end
+    end
+    
+    # times_notified must be a hash with contact names as keys
+    def contacts_to_notify(cycles, times_notified)
+      # cycles starts at 0, but user generally expects first down event to be cycle 1
+      
+      to_notify = []
+      @contacts.each do |contact|
+        next if times_notified[contact['name']].to_i >= contact['upto']
+        next if (cycles+1) < contact['after']
+        next if (cycles+1 - contact['after']) % contact['every'] != 0
+        to_notify << contact['name']
+      end
+      
+      to_notify
+    end
+    
+  end
+end

data/lib/nines/email_templates/notification.text.erb

@@ -0,0 +1,3 @@
+<%= check.name %> is <%= check.up ? 'UP' : 'DOWN' %> since <%= check.since %> (<%= human_duration(check.interval * check.cycles) %>)
+
+<%= details %>

data/lib/nines/http_check.rb

@@ -0,0 +1,42 @@
+require 'net/ping'
+require 'dnsruby'
+
+module Nines
+  class HttpCheck < Check
+    attr_accessor :uri, :up_statuses, :user_agent
+    
+    def initialize(group, options)
+      super(group, options)
+      
+      @uri = options['uri'] || "http://#{hostname}:#{port}/"
+      @up_statuses = options['up_statuses'] || [ 200 ]
+      @user_agent = options['user_agent'] || "nines/1.0"
+    end
+    
+    # shortcuts
+    def debug     ; Nines::App.debug    ; end
+    
+    def run
+      while Nines::App.continue do
+        check_started = Time.now
+        @address = Dnsruby::Resolv.getaddress(hostname)
+        
+        @pinger = Net::Ping::HTTP.new(uri, port, timeout)
+        @pinger.user_agent = user_agent
+        
+        # the check
+        log_status(@pinger.ping?, "#{uri} (#{address})#{@pinger.warning ? " [warning: #{@pinger.warning}]" : ''}")
+        
+        break if debug
+        
+        wait = interval.to_f - (Time.now - check_started)
+        while wait > 0 do
+          break unless Nines::App.continue
+          sleep [1, wait].min
+          wait -= 1
+        end
+      end
+    end
+    
+  end
+end

data/lib/nines/logger.rb

@@ -0,0 +1,26 @@
+module Nines
+  class Logger
+    
+    def initialize(io)
+      @mutex = Mutex.new
+      @io = io
+    end
+    
+    def sync       ; @io.sync       ; end
+    def sync=(val) ; @io.sync = val ; end
+    
+    def puts(*args)
+      @mutex.synchronize { @io.puts args }
+    end
+    alias_method :error, :puts
+    
+    def debug(*args)
+      @mutex.synchronize { @io.puts args } if Nines::App.verbose
+    end
+    
+    def close
+      @io.close unless @io == STDOUT || @io == STDERR
+    end
+    
+  end
+end

data/lib/nines/notifier.rb

@@ -0,0 +1,32 @@
+require 'mail'
+
+module Nines
+  class Notifier
+    
+    def initialize(contacts)
+      @contacts = contacts
+    end
+    
+    def notify!(contact_name, check, details = '')
+      contact = @contacts[contact_name]
+      email_body = ERB.new(File.open(Nines::App.root + '/lib/nines/email_templates/notification.text.erb').read).result(binding)
+      
+      Mail.deliver do
+        from      Nines::App.email_from
+        to        contact['email']
+        subject   "#{Nines::App.email_subject_prefix}#{check.name} is #{check.up ? 'UP' : 'DOWN'}"
+        body      email_body
+      end
+    end
+    
+    def human_duration(seconds)
+      case
+        when seconds < 60 then "#{seconds} sec"
+        when seconds < 3600 then "#{seconds/60} min #{seconds%60} sec"
+        when seconds < 86400 then "#{seconds/3600} hr #{seconds%3600/60} min #{seconds%60} sec"
+        else "#{seconds/86400} day #{seconds%86400/3600} hr #{seconds%3600/60} min #{seconds%60} sec"
+      end
+    end
+    
+  end
+end

data/lib/nines/ping_check.rb

@@ -0,0 +1,50 @@
+require 'net/ping'
+require 'dnsruby'
+
+module Nines
+  class PingCheck < Check
+    attr_accessor :protocol
+    
+    def initialize(group, options)
+      super(group, options)
+      
+      @protocol = (options['protocol'] || 'icmp').downcase
+    end
+    
+    # shortcuts
+    def debug     ; Nines::App.debug    ; end
+    
+    def run
+      while Nines::App.continue do
+        check_started = Time.now
+        @address = Dnsruby::Resolv.getaddress(hostname)
+        
+        @pinger = case protocol
+          when 'tcp'  then Net::Ping::TCP.new(hostname, nil, timeout)
+          when 'udp'  then Net::Ping::UDP.new(hostname, nil, timeout)
+          when 'icmp'
+            if Process::UID == 0
+              Net::Ping::ICMP.new(hostname, nil, timeout)
+            else
+              Net::Ping::External.new(hostname, nil, timeout)
+            end
+          else "invalid ping protocol #{protocol}"
+        end
+        
+        # the check
+        log_status(@pinger.ping?, "#{protocol == 'icmp' ? 'icmp' : "#{protocol}/#{port}"} ping on #{hostname} (#{address})")
+        
+        break if debug
+        
+        wait = interval.to_f - (Time.now - check_started)
+        while wait > 0 do
+          break unless Nines::App.continue
+          sleep [1, wait].min
+          wait -= 1
+        end
+      end
+    end
+    
+    
+  end
+end

data/lib/nines/version.rb

@@ -0,0 +1,3 @@
+module Nines
+  VERSION = "1.0.0"
+end

data/nines.gemspec

@@ -0,0 +1,29 @@
+$:.push File.expand_path("../lib", __FILE__)
+require "nines/version"
+
+Gem::Specification.new do |s|
+  s.platform    = Gem::Platform::RUBY
+  s.name        = 'nines'
+  s.version     = Nines::VERSION
+  s.summary     = 'Simple server monitoring tool written in pure Ruby.'
+  s.description = 'Nines is a simple server monitoring tool written in Ruby.'
+
+  s.required_ruby_version     = '>= 1.9.3'
+  s.required_rubygems_version = '>= 1.8.11'
+
+  s.author      = "Aaron Namba"
+  s.email       = "aaron@biggerbird.com"
+  s.homepage    = "https://github.com/anamba/nines"
+  s.license     = 'MIT'
+
+  s.bindir      = 'bin'
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency 'net-ping',     '~> 1.5.3'
+  s.add_dependency 'dnsruby',      '~> 1.53'
+  s.add_dependency 'mail',         '~> 2.4'
+  s.add_dependency 'trollop',      '~> 2.0'
+end

data/nines.rb.sample

@@ -0,0 +1,56 @@
+Nines::App.config = {
+  debug: false,
+  verbose: false,
+  
+  logfile: 'log/nines.log',
+  pidfile: 'tmp/nines.pid',
+  email_from: 'Nines Notifier <no-reply@example.com>',
+  email_subject_prefix: '[NINES] ',
+  
+  contacts: {
+    'admin-standard' => { email: 'admin@example.com' },
+    'admin-urgent' => { email: 'admin@example.com', twitter: 'admin_oncall', sms: '19875551234', phone: '19875554321' }
+  },
+  
+  check_groups: [
+    { name: 'Web Sites - High Priority',
+      description: 'Check often, notify immediately',
+      parameters: { type: :http, port: 80, timeout_sec: 5, interval_sec: 30 },
+      notify: [ { contact: 'admin-urgent', after: 2, every: 2, upto: 100 } ],
+      checks: [ 'www.corporation.com', 'www.clientabc.com' ]
+    },
+    { name: 'Web Sites - Low Priority',
+      description: 'Check infrequently, use urgent contact only after extended downtime',
+      parameters: { type: :http, port: 80, timeout_sec: 15, interval_sec: 300 },
+      notify: [
+        { contact: 'admin-standard', after: 2, every: 2, upto: 10 },
+        { contact: 'admin-urgent', after: 25, every: 10, upto: 10 }
+      ],
+      checks: [
+        'blog.johndoe.name',
+        { name: 'Blog Redirect', hostname: 'www.oldblogsite.com', up_statuses: [ 301 ] }
+      ]
+    },
+    { name: 'Servers',
+      description: 'Simple ping tests',
+      parameters: { type: :ping, protocol: :icmp, interval_sec: 60 },
+      notify: [
+        { contact: 'admin-standard', after: 2, every: 2, upto: 10 },
+        { contact: 'admin-urgent', after: 25, every: 10, upto: 10 }
+      ],
+      checks: [
+        'web1.hostingco.com',
+        { name: 'web1 admin IP', hostname: 'web1.hostingco.net' }
+      ]
+    },
+  ],
+  
+  smtp: {
+    address: 'smtp.sendgrid.net',
+    port: 587,
+    user_name: 'myusername',
+    password: 'mypassword',
+    authentication: 'plain',
+    enable_starttls_auto: true
+  }
+}

data/nines.yml.sample

@@ -0,0 +1,83 @@
+---
+debug: false
+verbose: false
+
+logfile: log/nines.log
+pidfile: tmp/nines.pid
+email_from: 'Nines Notifier <no-reply@calchost.com>'
+email_subject_prefix: '[NINES] '
+
+contacts:
+  admin-standard:
+    email: admin@example.com
+  admin-urgent:
+    email: admin@example.com
+    twitter: admin_oncall
+    sms: '19875551234'
+    phone: '19875554321'
+
+check_groups:
+- name: Web Sites - High Priority
+  description: Check often, notify immediately
+  parameters:
+    type: :http
+    port: 80
+    timeout_sec: 5
+    interval_sec: 30
+  notify:
+  - contact: admin-urgent
+    after: 2
+    every: 2
+    upto: 100
+  checks:
+  - www.corporation.com
+  - www.clientabc.com
+- name: Web Sites - Low Priority
+  description: Check infrequently, use urgent contact only after extended downtime
+  parameters:
+    type: http
+    port: 80
+    timeout_sec: 15
+    interval_sec: 300
+  notify:
+  - contact: admin-standard
+    after: 2
+    every: 2
+    upto: 10
+  - contact: admin-urgent
+    after: 25
+    every: 10
+    upto: 10
+  checks:
+  - blog.johndoe.name
+  - name: Blog Redirect
+    hostname: www.oldblogsite.com
+    up_statuses:
+    - 301
+- name: Servers
+  description: Simple ping tests
+  parameters:
+    type: ping
+    protocol: icmp
+    interval_sec: 60
+  notify:
+  - contact: admin-standard
+    after: 2
+    every: 2
+    upto: 10
+  - contact: admin-urgent
+    after: 25
+    every: 10
+    upto: 10
+  checks:
+  - web1.hostingco.com
+  - name: web1 admin IP
+    hostname: web1.hostingco.net
+
+smtp:
+  address: smtp.sendgrid.net
+  port: 587
+  user_name: myusername
+  password: mypassword
+  authentication: plain
+  enable_starttls_auto: true

metadata

@@ -0,0 +1,132 @@
+--- !ruby/object:Gem::Specification
+name: nines
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Aaron Namba
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: net-ping
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.5.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.5.3
+- !ruby/object:Gem::Dependency
+  name: dnsruby
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.53'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.53'
+- !ruby/object:Gem::Dependency
+  name: mail
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: trollop
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: Nines is a simple server monitoring tool written in Ruby.
+email: aaron@biggerbird.com
+executables:
+- nines
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rvmrc
+- MIT-LICENSE.txt
+- README.rdoc
+- bin/nines
+- doc/logrotate.conf
+- install.rb
+- lib/nines.rb
+- lib/nines/app.rb
+- lib/nines/check.rb
+- lib/nines/check_group.rb
+- lib/nines/email_templates/notification.text.erb
+- lib/nines/http_check.rb
+- lib/nines/logger.rb
+- lib/nines/notifier.rb
+- lib/nines/ping_check.rb
+- lib/nines/version.rb
+- log/.gitkeep
+- nines.gemspec
+- nines.rb.sample
+- nines.yml.sample
+- tmp/.gitkeep
+homepage: https://github.com/anamba/nines
+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: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.8.11
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Simple server monitoring tool written in pure Ruby.
+test_files: []