Switch branches/tags
Nothing to show
Clone or download
jnewland Merge pull request #9 from direktzu/master
Check for protected health methods in Ruby 2.0 too.
Latest commit 8b8d08d Aug 7, 2013



Pulse adds an action to your rails project that can be used for external health checking. The most common use is by a http proxy such as haproxy or a monitoring tool such as god.



  • Rails
  • MySQL, Postgres, or sqlite


Rails 3.x

Just add the gem to your Gemfile and then bundle install:

    gem 'rails-pulse'

In your config/routes.rb:

    # or customize the URL
    pulse '/admin/pulse'

Rails 2.x

In your config/environment.rb:

    config.gem 'rails-pulse', :source => "http://gemcutter.org/", :lib => "pulse"

Install the gem:

    rake gems:install

Finally, add a route to config/routes.rb:

    # or customize the URL
    map.pulse '/admin/pulse'

This configures pulse to work at the ‘pulse’ URL. If you would rather use a different URL:

    map.pulse 'some/other/url'

haproxy configuration

haproxy can be configured to use the /pulse url for its health checking. Just add:

    option httpchk GET /pulse
    listen rails :9000
      server rails-1 localhost:8000 maxconn 1 check inter 20000 fall 1
      server rails-2 localhost:8001 maxconn 1 check inter 20000 fall 1

god configuration

You are using god to watch your mongrels, right?

In your mongrel watch, add the following restart condition:

    w.restart_if do |restart|
      restart.condition(:http_response_code) do |c|
        c.code_is_not = 200
        c.host = 'localhost'
        c.path = '/pulse'
        c.port = 8000
        c.timeout = 5.seconds
        c.interval = 20.seconds

Also make sure to give your mongrels a nice grace period.

    w.start_grace = 90.seconds
    w.restart_grace = 90.seconds

For a complete god configuration example, check out my god_examples project and the included sample rails god config.


Released under Ruby’s license