Metrics, exception monitoring and request/response recording for rack apps
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Simple gem for monitoring Rack apps. Uses MongoDB underneath.

Intended to be used mostly on development and staging environments, mostly for APIs.


Simple gem that sits on top of Rack and:

  • monitors for exceptions and provides full details, like where it happened as well as the request details
  • records full requests/responses timelined, based on a header/header value
  • records request/response statistics

Each functionality can be enabled/disabled by the embedded dashboard.


Add this line to your application's Gemfile:

gem 'rack-reqorder'

And then execute:

bundle install

For Rails 5.x you need to add Sinatra 2.x in your Gemfile to use the dashboard

  gem "sinatra", ">= 2.0.0.rc1"


If you don't already have Mongoid in your app, you first need to initialize it by running:

bundle exec rails g mongoid:config

Then just add rack-reqorder in the middleware pipeline and initialize it.

For instance, in Rails, in an initializer add:

Rack::Reqorder.configure do |config|
  config.mongoid_yml = File.join(Rails.root, 'config', 'mongoid.yml')


#if you run on development mode
Rails.application.config.middleware.insert_after(ActionDispatch::DebugExceptions , Rack::Reqorder::Logger)
#or if run on production
#Rails.application.config.middleware.insert_after(0, Rack::Reqorder::Logger)

Then in routes.rb enable the little dashboard:

  mount Rack::Reqorder::Monitor::Web::Application => '/rack-reqorder'


After checking out the repo, run bin/setup to install dependencies. Then, run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release to create a git tag for the version, push git commits and tags, and push the .gem file to


  1. Fork it ( )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request