Mountable status page for your Rails application, to check Cache, Redis, Sidekiq ...
Ruby HTML JavaScript CSS
Clone or download
Pull request Compare This branch is 15 commits ahead, 174 commits behind lbeder:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.


Gem Version Build Status Dependency Status Coverage Status

Mountable status page for your Rails application, to check (DB, Cache, Sidekiq, Redis, etc.).

Mounting this gem will add a '/status' route to your application, which can be used for health monitoring the application and its various services. The method will return an appropriate HTTP status as well as a JSON array representing the state of each service.



# Gemfile
gem 'status-page'

Then run:

$ bundle install
# config/routes.rb
mount StatusPage::Engine, at: '/'

Supported service services

The following services are currently supported:

  • DB
  • Cache
  • Redis
  • Sidekiq
  • Resque


Adding services

By default, only the database check is enabled. You can add more service services by explicitly enabling them via an initializer:

StatusPage.configure do
  # Cache check status result 10 seconds
  self.interval = 10
  # Use service
  self.use :database
  self.use :cache
  self.use :redis
  # Custom redis url
  self.use :redis, url: 'redis://you-redis-host:3306/1'
  self.use :sidekiq

Adding a custom service

It's also possible to add custom health check services suited for your needs (of course, it's highly appreciated and encouraged if you'd contribute useful services to the project).

In order to add a custom service, you'd need to:

  • Implement the StatusPage::Services::Base class and its check! method (a check is considered as failed if it raises an exception):
class CustomService < StatusPage::Services::Base
  def check!
    raise 'Oh oh!'
  • Add its class to the config:
StatusPage.configure do

Adding a custom error callback

If you need to perform any additional error handling (for example, for additional error reporting), you can configure a custom error callback:

StatusPage.configure do
  self.error_callback = proc do |e|
    logger.error "Health check failed with: #{e.message}"


Adding authentication credentials

By default, the /status endpoint is not authenticated and is available to any user. You can authenticate using HTTP Basic Auth by providing authentication credentials:

StatusPage.configure do
  self.basic_auth_credentials = {
    username: 'SECRET_NAME',
    password: 'Shhhhh!!!'


The MIT License (MIT)