Flail is an exception catcher for Rack applications.

Supports
  • Rails 3.x, 4.x, 5.x
  • (See earlier 0.x.x releases for Rails 2.3.x support)

Install

Rails 3
gem :flail

Usage

Add an initializer to configure (or call configure during application startup):

Flail.configure do
  # configure a custom handler for the error payload
  # don't call if you want to use the default http post handler
  handle do |payload|
  end

  # endpoint for default handler
  url "https://flail.net/swing"

  # environment of application, defaults to Rails.env
  # included in payload
  environment "production"

  # hostname to use of server, defaults to Socket.gethostname
  # included in payload
  host Socket.gethostname

  # arbitrary tag (api key) which can identify
  # your project or be anything else
  tagged "custom_key"
end

Helpful Additions

See flail_web for a Rails 3 application designed to receive flail exceptions so you can inspect them. https://github.com/asceth/flail_web

Authors

Original author: John "asceth" Long

Contributor: Ben Fenner