Heartcheck

Heartcheck is a monitoring tool for Rack applications. It provides a DSL to declare service checks and an URI that returns the status for each service. With this gem you can monitor if your app has access to the database, a cache service, an API, etc.

Add this line to your application's Gemfile:

gem 'heartcheck'

And then execute:

$ bundle

Or install it yourself as:

$ gem install heartcheck

First generate the config file for the framework you are using:

$ heartcheck rails
$ heartcheck padrino
$ heartcheck sinatra

Then edit the generated file by adding your checks on it and restart your server. Now you should be able to make a HTTP request for /monitoring and get a JSON response that contains the status for each monitored service.

The following environment variables are needed by heartcheck:

HEARTCHECK_APP_NAME=MyApplicationName

Heartcheck.setup do |config|
  config.add :firewall do |c|
    c.add_service(host: 'domain.com', port: 80)
    c.add_service(host: 'domain.com', port: 80, timeout: 5) # Default timeout is 2 seconds
    c.add_service(url: 'https://domain.com')
    c.add_service(url: 'https://domain.com', proxy: 'http://proxy.domain.com')
  end
end

To get the status for all services, make a HTTP request for the following URI:

/monitoring

It will return a JSON response and a status for each service.

Functional services are services essential for your application. You can get their status using the following route:

/monitoring/functional

This route returns custom information about your app. You can configure it to return whatever information you want:

/monitoring/info

Returns some debugging information:

/monitoring/dev

Returns a simple ok if the app is running. It does not execute any configured checks:

/monitoring/health_check

Returns general application info and a list of dependencies' URIs, but executes no checking:

/monitoring/inspect

An optional formatter may be set for the monitoring response. We provide the default format using a list of hashes and one with a single Hash. Please check Heartcheck.use_hash_formatter!

• ActiveRecord
• Cache
• Cas
• Paypal
• Redis
• Resque
• Sidekiq
• Webservice

Bug reports and pull requests are welcome on GitHub at https://github.com/locaweb/heartcheck.

Heartcheck can be setup with Docker and Docker Compose on macOS or Linux systems, so that you don't need to install ruby and it's dependencies via rbenv or rvm.

Just do your setup locally by running:

./scripts/heartcheck setup

Run ./scripts/heartcheck -h to see available options, such as bash, rspec, etc.