mysql_health 0.5.0

data/.gitignore

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

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 osterman
+
+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,63 @@
+# MysqlHealth
+
+MySQL Health is a standalone HTTP server that will respond with a 200 status code when MySQL is operating as expected. 
+
+This script is intended to be used in conjuction with HAProxy "option httpchk" for a TCP load balancer distributing load across mysql servers.
+
+## FAQs
+
+1. If you get the error "caught DBI::InterfaceError exception 'Could not load driver (uninitialized constant MysqlError)'" on OSX, try doing this:
+`export DYLD_LIBRARY_PATH="/usr/local/mysql/lib:$DYLD_LIBRARY_PATH"`
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'mysql_health'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install mysql_health
+
+## Usage
+
+    Usage: mysql_health options
+            --check:master               Master health check
+            --check:slave                Slave health check
+            --check:allow-overlapping    Allow overlapping health checks (default: false)
+            --check:interval INTERVAL    Check health every INTERVAL (default: 10s)
+            --check:delay DELAY          Delay health checks for INTERVAL (default: 0s)
+            --check:dsn DSN              MySQL DSN (default: DBI:Mysql:mysql:localhost)
+            --check:username USERNAME    MySQL Username (default: root)
+            --check:password PASSWORD    MySQL Password (default: )
+        -l, --server:listen ADDR         Server listen address (default: 0.0.0.0)
+        -p, --server:port PORT           Server listen port (default: 3305)
+        -d, --server:daemonize           Daemonize the process (default: false)
+        -P, --server:pid-file PID-FILE   Pid-File to save the process id (default: false)
+            --log:level LEVEL            Logging level (default: INFO)
+            --log:file FILE              Write logs to FILE (default: STDERR)
+            --log:age DAYS               Rotate logs after DAYS pass (default: 7)
+            --log:size SIZE              Rotate logs after the grow past SIZE bytes (default: 10485760)
+
+## Examples
+
+Start the server on port 1234 and check the status of the slave every 30 seconds:
+
+    mysql_health --check:slave --check:interval 30 --server:port 1234
+
+Start the server on port 1234 and check the status of the master every 30 seconds:
+
+    mysql_health --check:master --check:interval 30 --server:port 1234
+
+## 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,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/bin/mysql_health

@@ -0,0 +1,30 @@
+#!/usr/bin/env ruby
+#
+# mysql_health - a service for monitoring MySQL and exposing its health through an HTTP interface
+# Copyright (C) 2012 Erik Osterman <e@osterman.com>
+# 
+# This file is part of mysql_health.
+# 
+# mysql_health is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# mysql_health is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License
+# along with mysql_health.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+$:.unshift(File.expand_path('.')) # Ruby 1.9 doesn't have . in the load path...
+$:.push(File.expand_path('lib/')) 
+
+require 'rubygems'
+require 'mysql_health'
+
+command_line = MysqlHealth::CommandLine.new
+command_line.execute
+

data/lib/mysql_health.rb

@@ -0,0 +1,27 @@
+#
+# mysql_health - a service for monitoring MySQL and exposing its health through an HTTP interface
+# Copyright (C) 2012 Erik Osterman <e@osterman.com>
+# 
+# This file is part of mysql_health.
+# 
+# mysql_health is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# mysql_health is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License
+# along with mysql_health.  If not, see <http://www.gnu.org/licenses/>.
+#
+require 'mysql_health/version'
+require 'mysql_health/health'
+require 'mysql_health/server'
+require 'mysql_health/command_line'
+
+module MysqlHealth
+
+end

data/lib/mysql_health/command_line.rb

@@ -0,0 +1,199 @@
+#
+# mysql_health - a service for monitoring MySQL and exposing its health through an HTTP interface
+# Copyright (C) 2012 Erik Osterman <e@osterman.com>
+# 
+# This file is part of mysql_health.
+# 
+# mysql_health is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# mysql_health is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License
+# along with mysql_health.  If not, see <http://www.gnu.org/licenses/>.
+#
+require 'logger'
+require 'optparse'
+
+module MysqlHealth
+  @@health = nil
+  @@log = nil
+  
+  def self.health 
+    @@health
+  end
+
+  def self.health=(health)
+    @@health = health
+  end
+
+  def self.log
+    @@log
+  end
+
+  def self.log=(log)
+    @@log = log
+  end
+
+  class ArgumentException < Exception; end
+  class CommandLine
+    attr_accessor :options
+    def initialize
+      @options = {}
+      @options[:server] = {}
+      @options[:check] = {}
+      @options[:log] = {}
+
+      begin
+        @optparse = OptionParser.new do |opts|
+          opts.banner = "Usage: #{$0} options"
+          #
+          # Health check
+          #
+          @options[:check][:master] = false
+          opts.on( '--check:master', 'Master health check') do
+            @options[:check][:master] = true
+          end
+
+          @options[:check][:slave] = false
+          opts.on( '--check:slave', 'Slave health check') do |host|
+            @options[:check][:slave] = true
+          end
+
+          @options[:check][:allow_overlapping] = false
+          opts.on( '--check:allow-overlapping', "Allow overlapping health checks (default: #{@options[:check][:allow_overlapping]})") do
+            @options[:check][:allow_overlapping] = true
+          end
+
+          @options[:check][:interval] = '10s'
+          opts.on( '--check:interval INTERVAL', "Check health every INTERVAL (default: #{@options[:check][:interval]})") do |interval|
+            @options[:check][:interval] = interval.to_s
+          end
+
+          @options[:check][:delay] = '0s'
+          opts.on( '--check:delay DELAY', "Delay health checks for INTERVAL (default: #{@options[:check][:delay]})") do |delay|
+            @options[:check][:delay] = interval.to_s
+          end
+
+          @options[:check][:dsn] ||= "DBI:Mysql:mysql:localhost"
+          opts.on( '--check:dsn DSN', "MySQL DSN (default: #{@options[:check][:dsn]})") do |dsn|
+            @options[:check][:dsn] = dsn.to_s
+          end
+
+          @options[:check][:username] ||= "root"
+          opts.on( '--check:username USERNAME', "MySQL Username (default: #{@options[:check][:username]})") do |username|
+            @options[:check][:username] = username.to_s
+          end
+
+          @options[:check][:password] ||= ""
+          opts.on( '--check:password PASSWORD', "MySQL Password (default: #{@options[:check][:password]})") do |password|
+            @options[:check][:password] = interval.to_s
+          end
+
+          # Server
+          @options[:server][:listen] = '0.0.0.0'
+          opts.on( '-l', '--server:listen ADDR', "Server listen address (default: #{@options[:server][:listen]})") do |addr|
+            @options[:server][:addr] = host.to_s
+          end
+
+          @options[:server][:port] = 3305
+          opts.on( '-p', '--server:port PORT', "Server listen port (default: #{@options[:server][:port]})") do |port|
+            @options[:server][:port] = port.to_i
+          end
+
+          @options[:server][:daemonize] = false
+          opts.on( '-d', '--server:daemonize', "Daemonize the process (default: #{@options[:server][:daemonize]})") do
+            @options[:server][:daemonize] = true
+          end
+
+          @options[:server][:pid_file] = false
+          opts.on('-P', '--server:pid-file PID-FILE', "Pid-File to save the process id (default: #{@options[:server][:pid_file]})") do |pid_file|
+            @options[:server][:pid_file] = pid_file
+          end
+ 
+
+          #
+          # Logging
+          #
+
+          @options[:log][:level] = Logger::INFO
+          opts.on( '--log:level LEVEL', 'Logging level (default: INFO)' ) do|level|
+            @options[:log][:level] = Logger.const_get level.upcase
+          end
+
+          @options[:log][:file] = STDERR
+          opts.on( '--log:file FILE', 'Write logs to FILE (default: STDERR)' ) do|file|
+            @options[:log][:file] = File.open(file, File::WRONLY | File::APPEND | File::CREAT)
+          end
+
+          @options[:log][:age] = 7
+          opts.on( '--log:age DAYS', "Rotate logs after DAYS pass (default: #{@options[:log][:age]})" ) do|days|
+            @options[:log][:age] = days.to_i
+          end
+
+          @options[:log][:size] = 1024*1024*10
+          opts.on( '--log:size SIZE', "Rotate logs after the grow past SIZE bytes (default: #{@options[:log][:size]})" ) do |size|
+            @options[:log][:size] = size.to_i
+          end
+        end
+        @optparse.parse!
+
+        raise ArgumentException.new("No action specified") if @options[:check][:master] == false && @options[:check][:slave] == false
+        @log = Logger.new(@options[:log][:file], @options[:log][:age], @options[:log][:size])
+        @log.level = @options[:log][:level]
+
+        daemonize if @options[:server][:daemonize]
+        write_pid_file if @options[:server][:pid_file]
+
+        MysqlHealth.log = @log
+        MysqlHealth.health = Health.new(@options[:check])
+
+      rescue ArgumentException => e
+        puts e.message
+        puts @optparse
+        exit 1
+      end
+    end
+
+    def daemonize
+      # Become a daemon
+      if RUBY_VERSION < "1.9"
+        exit if fork
+        Process.setsid
+        exit if fork
+        Dir.chdir "/" 
+        STDIN.reopen "/dev/null"
+        STDOUT.reopen "/dev/null", "a" 
+        STDERR.reopen "/dev/null", "a" 
+      else
+        Process.daemon
+      end 
+    end
+
+    def write_pid_file
+      @log.debug("writing pid file #{@options[:server][:pid_file]}")
+      File.open(@options[:server][:pid_file], 'w') do |f| 
+        f.write(Process.pid)
+      end
+    end
+
+    def execute
+      begin
+        ::EM.run do
+          ::EM.start_server @options[:server][:listen], @options[:server][:port], Server
+        end
+      rescue ArgumentException => e
+        @log.fatal(e.message)
+      rescue Interrupt => e
+        @log.info("exiting...")
+      rescue Exception => e
+        @log.fatal(e.message + e.backtrace.join("\n"))
+      end
+    end
+  end
+end

data/lib/mysql_health/health.rb

@@ -0,0 +1,181 @@
+#
+# mysql_health - a service for monitoring MySQL and exposing its health through an HTTP interface
+# Copyright (C) 2012 Erik Osterman <e@osterman.com>
+# 
+# This file is part of mysql_health.
+# 
+# mysql_health is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# mysql_health is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License
+# along with mysql_health.  If not, see <http://www.gnu.org/licenses/>.
+#
+require 'dbi'
+require 'mysql'
+require 'json'
+require 'rufus-scheduler'
+
+module MysqlHealth
+  class Health
+    @master_status = nil
+    @slave_status = nil
+    @scheduler = nil
+    @options = nil
+
+    def initialize(options = {})
+      @options = options
+
+      @mutex = Mutex.new
+      @scheduler = Rufus::Scheduler.start_new
+      def @scheduler.handle_exception(job, e)
+        MysqlHealth.log.error "job #{job.job_id} caught #{e.class} exception '#{e}' #{e.backtrace.join("\n")}"
+      end
+
+      if options[:master]
+        master_status = {}
+        master_status[:status] = 503
+        master_status[:content] = "Health of master not yet determined\n"
+        self.master_status=(master_status)
+        @scheduler.every options[:interval], :allow_overlapping => options[:allow_overlapping], :first_in => options[:delay] do 
+          check_master
+        end
+      else
+        master_status = {}
+        master_status[:status] = '501 Not Enabled'
+        master_status[:content] = "Health of master not enabled\n"
+        self.master_status=(master_status)
+      end
+
+      if options[:slave]
+        slave_status = {}
+        slave_status[:status] = '501 Not Enabled'
+        slave_status[:content] = "Health of slave not yet determined\n"
+        self.slave_status=(slave_status)
+        @scheduler.every options[:interval], :allow_overlapping => options[:allow_overlapping], :first_in => options[:delay] do 
+          check_slave
+        end
+      else
+        slave_status = {}
+        slave_status[:status] = '501 Not Enabled'
+        slave_status[:content] = "Health of slave not enabled\n"
+        self.slave_status=(slave_status)
+      end
+    end
+
+    def master_status=(response)
+      @mutex.synchronize do
+        MysqlHealth.log.info("master status: #{response[:status]}")
+        @master_status = response
+      end
+    end
+
+    def master_status 
+      master_status = nil
+      @mutex.synchronize do
+        master_status = @master_status
+      end
+      return master_status
+    end
+
+    def slave_status=(response)
+      @mutex.synchronize do 
+        MysqlHealth.log.info("slave status: #{response[:status]}")
+        @slave_status = response
+      end
+    end
+    
+    def slave_status
+      slave_status = nil
+      @mutex.synchronize do
+        slave_status = @slave_status
+      end
+      return slave_status
+    end
+
+    def read_only?(dbh)
+      variables = dbh.select_all("SHOW VARIABLES WHERE Variable_name = 'read_only' AND Value = 'ON'")
+      return (variables.length == 1)
+    end
+
+    def check_master
+      MysqlHealth.log.debug("check_master")
+
+      # connect to the MySQL server
+      dbh = DBI.connect(@options[:dsn], @options[:username], @options[:password])
+
+      response = {}
+      response[:content_type] = 'text/plain'
+
+      status = {}
+      dbh.select_all('SHOW STATUS') do |row|
+        status[row[0].downcase.to_sym] = row[1]
+      end
+      mysqladmin_status = "Uptime: %s  Threads: %s  Questions: %s  Slow queries: %s  Opens: %s  Flush tables: %s  Open tables: %s  Queries per second avg: %.3f\n" %
+                [ status[:uptime], status[:threads_running], status[:questions], status[:slow_queries], status[:opened_tables], status[:flush_commands], status[:open_tables], status[:queries].to_i/status[:uptime].to_i]
+      if status.length > 0
+        if read_only?(dbh)
+          response[:status] = '503 Service Read Only'
+          response[:content] = mysqladmin_status
+        else
+          response[:status] = '200 OK'
+          response[:content] = mysqladmin_status
+        end
+      else
+        response[:status] = '503 Service Unavailable'
+        response[:content] = mysqladmin_status
+      end
+      self.master_status=(response)
+    end
+
+    def check_slave
+      MysqlHealth.log.debug("check_slave")
+
+      # connect to the MySQL server
+      dbh = DBI.connect(@options[:dsn], @options[:username], @options[:password])
+
+      response = {}
+      response[:content_type] = 'text/plain'
+
+      show_slave_status = []
+      status = {}
+      dbh.select_all('SHOW SLAVE STATUS') do |row|
+        status[row[0].downcase.to_sym] = row[1]
+        show_slave_status << "#{row[0]}: #{row[1]}"
+      end
+
+      if status.length > 0
+        seconds_behind_master = status[:seconds_behind_master]
+
+        # We return a "203 Non-Authoritative Information" when replication is shot. We don't want to reduce site performance, but still want to track that something is awry.
+        if seconds_behind_master.eql?('NULL')
+          response[:status] = '203 Slave Stopped'
+          response[:content] = status.to_json
+          response[:content_type] = 'application/json'
+        elsif seconds_behind_master.to_i > 60*30
+          response[:status] = '203 Slave Behind'
+          response[:content] = status.to_json
+          response[:content_type] = 'application/json'
+        elsif read_only?(dbh)
+          response[:status] = '200 OK ' + seconds_behind_master  + ' Seconds Behind Master'
+          response[:content] = status.to_json
+          response[:content_type] = 'application/json'
+        else
+          response[:status] = '503 Service Unavailable'
+          response[:content] = status.to_json
+          response[:content_type] = 'application/json'
+        end
+      else
+        response[:status] = '503 Slave Not Configured'
+        response[:content] = show_slave_status.join("\n")
+      end
+      self.slave_status=(response)
+    end
+  end
+end

data/lib/mysql_health/server.rb

@@ -0,0 +1,76 @@
+#
+# mysql_health - a service for monitoring MySQL and exposing its health through an HTTP interface
+# Copyright (C) 2012 Erik Osterman <e@osterman.com>
+# 
+# This file is part of mysql_health.
+# 
+# mysql_health is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# mysql_health is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License
+# along with mysql_health.  If not, see <http://www.gnu.org/licenses/>.
+#
+require 'json'
+require 'eventmachine'
+require 'eventmachine_httpserver'
+require 'evma_httpserver/response'
+require 'forwardable'
+
+module MysqlHealth
+  class Server < ::EM::Connection
+    include ::EM::HttpServer
+
+    def post_init
+      super
+      no_environment_strings
+    end
+
+    def http_response(data)
+       MysqlHealth.log.debug("http_response")
+      response = EventMachine::DelegatedHttpResponse.new(self)
+      if data.instance_of?(OpenStruct)
+        puts data.table.inspect
+        puts data.inspect
+      end
+       
+      if data.nil?
+        response.status = '500 Server Error'
+        response.content = "Empty call to http_response\n"
+      else
+        data.each_pair do |k,v|
+          MysqlHealth.log.debug("#{k}=#{v}")
+          if k == :content_type
+            response.send(k, v)
+          else
+            response.send("#{k}=".to_sym, v)
+          end
+        end
+      end
+      response
+    end
+
+    def process_http_request
+      response = nil
+      begin
+        case @http_path_info
+        when '/master_status'
+          response = http_response(MysqlHealth.health.master_status)
+        when '/slave_status'
+          response = http_response(MysqlHealth.health.slave_status)
+        else
+          response = http_response({:status => '501 Not Implemented'})
+        end
+      rescue Exception => e
+        response = http_response({:status => '500 Server Error', :content => e.message + "\n" + e.backtrace.join("\n")})
+      end
+      response.send_response
+    end
+  end
+end

data/lib/mysql_health/version.rb

@@ -0,0 +1,22 @@
+#
+# mysql_health - a service for monitoring MySQL and exposing its health through an HTTP interface
+# Copyright (C) 2012 Erik Osterman <e@osterman.com>
+# 
+# This file is part of mysql_health.
+# 
+# mysql_health is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# mysql_health is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License
+# along with mysql_health.  If not, see <http://www.gnu.org/licenses/>.
+#
+module MysqlHealth
+  VERSION = "0.5.0"
+end

data/mysql_health.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/mysql_health/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Erik Osterman"]
+  gem.email         = ["e@osterman.com"]
+  gem.summary       = %q{A service for monitoring MySQL and exposing its health through an HTTP interface.}
+  gem.description   = %q{A service for monitoring MySQL and exposing its health through an HTTP interface for use with TCP load balancers (like haproxy) that support out-of-band health checks using HTTP.}
+  gem.homepage      = "https://github.com/osterman/mysql_health"
+  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{^(test|spec|features)/})
+  gem.name          = "mysql_health"
+  gem.license       = 'GPLv3'
+  gem.require_paths = ["lib"]
+  gem.version       = MysqlHealth::VERSION
+  gem.add_runtime_dependency('rufus-scheduler',  '>= 2.0.17')
+  gem.add_runtime_dependency('eventmachine', '>= 1.0.0.beta.4')
+  gem.add_runtime_dependency('eventmachine_httpserver', '>= 0.2.1')
+  gem.add_runtime_dependency('json', '>= 1.5.3')
+  gem.add_runtime_dependency('dbi', '>= 0.4.5')
+  gem.add_runtime_dependency('mysql', '>= 2.8.1')
+end

data/redhat/mysql_health.initrc

@@ -0,0 +1,117 @@
+#!/bin/bash
+#
+# mysql_health - a service for monitoring MySQL and exposing its health through an HTTP interface.
+#
+# chkconfig: 345 99 99
+# description: mysql_health
+# processname: mysql_health
+
+
+# Source function library.
+. /etc/rc.d/init.d/functions
+
+MYSQL_HEALTH_NICE="-n 19"
+MYSQL_HEALTH_BIN="/usr/bin/mysql_health"
+MYSQL_HEALTH_LOG="/var/log/mysql_health.log"
+MYSQL_HEALTH_PID_FILE="/var/run/mysql_health.pid"
+MYSQL_HEALTH_HOME="/tmp"
+MYSQL_HEALTH_ARGS=""
+
+[ -f /etc/sysconfig/mysql_health ] && . /etc/sysconfig/mysql_health
+
+[ -x /usr/bin/mysql_health ] || exit 0
+
+
+start_mysql_health()
+{
+  cd $MYSQL_HEALTH_HOME
+  echo -n $"Starting mysql_health"
+  nice $MYSQL_HEALTH_NICE $MYSQL_HEALTH_BIN --server:pid-file="$MYSQL_HEALTH_PID_FILE" --log:file "$MYSQL_HEALTH_LOG" --server:daemonize $MYSQL_HEALTH_ARGS
+  result=$?
+  if [ "$result" -eq 0 ]; then
+    sleep 0.5
+    status -p "$MYSQL_HEALTH_PID_FILE" >/dev/null
+    result=$?
+    if [ "$result" -eq 0 ]; then
+      success
+    else
+      failure
+    fi
+  else
+    failure
+  fi
+  echo
+  return $result
+}
+
+stop_mysql_health()
+{
+  echo -n $"Stopping mysql_health"
+
+  if [ -f "$MYSQL_HEALTH_PID_FILE" ]; then
+    kill $(cat "$MYSQL_HEALTH_PID_FILE") 2>/dev/null
+    result=$?
+  else
+    result=1
+  fi
+
+  if [ "$result" -eq 0 ]; then
+    result=1
+    for i in {1..60}; do
+      if [ -f "$MYSQL_HEALTH_PID_FILE" ]; then
+        echo -n "."
+        sleep 1
+      else
+        result=0
+        break
+      fi
+    done
+  fi
+
+  if [ "$result" -eq 0 ];then
+    success
+  else
+    failure
+  fi
+  echo
+  return $result
+}
+
+
+status_mysql_health() {
+  echo -n "mysql_health"
+  if [ -f "$MYSQL_HEALTH_PID_FILE" ]; then
+    status -p "$MYSQL_HEALTH_PID_FILE"
+  else
+    echo " is not running"
+  fi
+}
+
+status=0
+# See how we were called.
+case "$1" in
+  start)
+  start_mysql_health
+  status=$?
+        ;;
+  stop)
+  stop_mysql_health
+  status=$?
+        ;;
+  restart|reload)
+  stop_mysql_health
+  sleep 1
+  start_mysql_health
+  status=$?
+  ;;
+  status)
+  status_mysql_health
+  status=$?
+  ;;
+  *)
+  echo $"Usage: $0 {start|stop|restart|reload}"
+  status=1
+esac
+
+exit $status
+exit 0

data/redhat/rubygem-mysql_health.spec

@@ -0,0 +1,73 @@
+%define ruby_sitelib %(ruby -rrbconfig -e "puts Config::CONFIG['sitelibdir']")
+%define gemdir %(ruby -rubygems -e 'puts Gem::dir' 2>/dev/null)
+%define gemname mysql_health
+%define gemversion 0.3.0
+%define geminstdir %{gemdir}/gems/%{gemname}-%{gemversion}
+%define gemfile %{gemname}-%{gemversion}.gem
+%define gemsummary %(ruby -rrubygems -e 'puts YAML.load(`gem specification %{gemfile}`).summary')
+%define gemdesc %(ruby -rrubygems -e 'puts YAML.load(`gem specification %{gemfile}`).description')
+%define gemhomepage %(ruby -rrubygems -e 'puts YAML.load(`gem specification %{gemfile}`).homepage')
+%define gemlicense %(ruby -rrubygems -e 'puts YAML.load(`gem specification %{gemfile}`).license || "Unknown"')
+%define gemdeps %(ruby -rrubygems -e 'puts YAML.load(`gem specification %{gemfile}`.chomp).dependencies.map { |d| "rubygem(%s) %s" % [d.name, d.requirement] }.sort.join(", ")')
+%define gemrelease %(date +"%%Y%%m%%d%%H%%M%%S")
+
+Summary: %{gemsummary}
+# The version is repeated in the name so as to allow multiple versions of the gem to be installed on the system.
+Name: rubygem-%{gemname}-%{gemversion}
+Version: %{gemversion}
+Release: %{gemrelease}%{?dist}
+Group: Development/Languages
+License: %{gemlicense}
+URL: %{gemhomepage}
+Source0: http://rubygems.org/gems/%{gemname}-%{version}.gem
+BuildRoot: %{_tmppath}/%{name}-%{version}-%{release}-root-%(%{__id_u} -n)
+Requires: rubygems
+
+Requires: %{gemdeps}
+
+BuildRequires: rubygems
+BuildRequires: rubygem(bundler)
+BuildArch: noarch
+Provides: rubygem(%{gemname}) = %{version}
+
+%description
+%{gemdesc}
+
+%prep
+
+%build
+
+%install
+rm -rf %{buildroot}
+install --directory 0755 %{buildroot}%{gemdir}
+gem install --local --install-dir %{buildroot}%{gemdir} \
+            --force --rdoc %{SOURCE0}
+install --directory 0755 %{buildroot}/%{_bindir}
+mv %{buildroot}%{gemdir}/bin/%{gemname} %{buildroot}/%{_bindir}
+find %{buildroot}%{geminstdir}/bin -type f | xargs chmod a+x
+
+install --directory --mode 0755 %{buildroot}%{_sysconfdir}/%{gemname}
+install --directory --mode 0755 %{buildroot}%{_initrddir}
+install --mode 755 %{buildroot}%{geminstdir}/redhat/%{gemname}.initrc %{buildroot}%{_initrddir}/%{gemname}
+
+install --directory --mode 0755 %{buildroot}%{_sysconfdir}/sysconfig
+cat<<__EOF__>%{buildroot}/%{_sysconfdir}/sysconfig/%{gemname}
+__EOF__
+
+%clean
+rm -rf %{buildroot}
+
+%files
+%defattr(-, root, root, -)
+%{_bindir}/%{gemname}
+%{gemdir}/gems/%{gemname}-%{version}/
+%doc %{gemdir}/doc/%{gemname}-%{version}
+%{gemdir}/cache/%{gemname}-%{version}.gem
+%{gemdir}/specifications/%{gemname}-%{version}.gemspec
+%{_initrddir}/%{gemname}
+%{_sysconfdir}/%{gemname}/
+%{_sysconfdir}/sysconfig/%{gemname}
+
+%changelog
+* Sun Jul 29 2012 Erik Osterman <e@osterman.com>
+- Initial package

metadata

@@ -0,0 +1,161 @@
+--- !ruby/object:Gem::Specification 
+name: mysql_health
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 5
+  - 0
+  version: 0.5.0
+platform: ruby
+authors: 
+- Erik Osterman
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-07-29 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rufus-scheduler
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 0
+        - 17
+        version: 2.0.17
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: eventmachine
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 0
+        - 0
+        - beta
+        - 4
+        version: 1.0.0.beta.4
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: eventmachine_httpserver
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 2
+        - 1
+        version: 0.2.1
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 5
+        - 3
+        version: 1.5.3
+  type: :runtime
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: dbi
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 4
+        - 5
+        version: 0.4.5
+  type: :runtime
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: mysql
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 8
+        - 1
+        version: 2.8.1
+  type: :runtime
+  version_requirements: *id006
+description: A service for monitoring MySQL and exposing its health through an HTTP interface for use with TCP load balancers (like haproxy) that support out-of-band health checks using HTTP.
+email: 
+- e@osterman.com
+executables: 
+- mysql_health
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/mysql_health
+- lib/mysql_health.rb
+- lib/mysql_health/command_line.rb
+- lib/mysql_health/health.rb
+- lib/mysql_health/server.rb
+- lib/mysql_health/version.rb
+- mysql_health.gemspec
+- redhat/mysql_health.initrc
+- redhat/rubygem-mysql_health.spec
+has_rdoc: true
+homepage: https://github.com/osterman/mysql_health
+licenses: 
+- GPLv3
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: A service for monitoring MySQL and exposing its health through an HTTP interface.
+test_files: []
+