redis-health 0.0.1

data/README.md

@@ -0,0 +1,42 @@
+### Redis Health is a simple monitoring tool for Redis that notifies when abnormal things are happening in Redis.
+
+Install:
+    gem install 'redis-health'
+
+Use:
+    require 'redis'
+    require 'redis-health'
+    require 'pony'
+
+    RedisHealth.configure do
+      watch('worker count fell below 2 for more then 1 minute') do
+        v = redis.scard('resque:party:workers')
+        {triggered: v < 2, value: v}
+      end
+
+      watch('redis connected client count fell below 3 for more then 30 seconds', 30) do
+        client_count = redis.info['connected_clients'].to_i
+        {triggered: client_count < 3, value: client_count}
+      end
+
+      watch('HOLY **** TEH FAIL LOGZ IZ HUGE', 1) do
+        v = redis.llen('resque:party:failed')
+        {triggered: v > 1000, value: v}
+      end
+
+      notify do |notices|
+        #TEXT EMAIL FAX POSTCARD TWEET GOES HERE
+        Pony.mail(:to => 'steve@hypermegaglobacorp.web', :from => 'failbot@hypermegaglobacorp.web', :html_body => '<h1>Some stuff seems to have failed, take a look pretty please</h1> ' + notices.join(', '))
+      end
+    end
+
+    redis = Redis.new
+
+    #runs watches and sleeps for 1 second in a loop
+    RedisHealth.new(redis).run
+
+It calls your notifier block if a watch has been triggered for the specified number of seconds, passing it a list of triggered messages such as:
+    ['HOLY **** TEH FAIL LOGZ IZ HUGE, value is now 100000', 'worker count fell below 2 for more then 1 minute, value is now 0']
+
+And calls it again if a watch ceases to trigger, with a list of triggered messages such as:
+    ['HOLY **** TEH FAIL LOGZ IZ HUGE no longer in effect, value is 10', 'worker count fell below 2 for more then 1 minute no longer in effect, value is now 100000']

data/lib/redis_health.rb

@@ -0,0 +1,80 @@
+class RedisHealth
+  VERSION = '0.0.1'
+  attr_accessor :redis, :triggered_times
+  @watchers = {}
+
+  class << self
+    attr_accessor :watchers, :notifier
+
+    def configure(&blk)
+      instance_eval(&blk)
+    end
+
+    def watch(label, time = 60, &blk)
+      w = {
+        :time => time,
+        :matcher => blk
+      }
+      watchers[label] = w
+      [label, w]
+    end
+
+    def notify(&blk)
+      @notifier = blk
+    end
+  end
+
+  def initialize(redis)
+    @redis = redis
+    @triggered_times = {}
+  end
+
+  def execute_watches
+    self.class.watchers.collect do |watcher_array|
+      label, watcher_hash = watcher_array
+      triggered_times[label] ||= 0
+
+      matcher_result = self.instance_eval(&watcher_hash[:matcher])#.call(@redis)
+      triggered = matcher_result[:triggered]
+      value = matcher_result[:value]
+      notice = append_label_value(label, value, triggered)
+      times_was = triggered_times[label]
+
+      if triggered
+        triggered_times[label] += 1
+        if times_was == watcher_hash[:time]
+          notice
+        end
+      else
+        triggered_times[label] = 0
+        if times_was > 0 && times_was >= watcher_hash[:time]
+          notice
+        else
+          nil
+        end
+      end
+    end.compact
+  end
+
+  def notify
+    notices = execute_watches
+    self.class.notifier.call(notices) unless notices.empty?
+  end
+
+  def run
+    loop do
+      notify
+      sleep 1
+    end
+  end
+
+  private
+
+  def append_label_value(label, v, triggered)
+    notice = label
+    notice += ' is no longer in effect' unless triggered
+    notice += ", value is now #{v}" if v
+    notice
+  end
+end
+

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification
+name: redis-health
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Max Justus Spransy
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-10-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: redis
+  requirement: &70131276238940 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70131276238940
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70131276238200 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.6.0
+  type: :development
+  prerelease: false
+  version_requirements: *70131276238200
+description: When shit hits the fan in your redis db, Redis Health lets you know before
+  your customers do
+email: maxjustus@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/redis_health.rb
+- README.md
+homepage: http://github.com/maxjustus/Redis-Health
+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.11
+signing_key: 
+specification_version: 3
+summary: Knowing is half the battle
+test_files: []