Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
The official Airbrake library for Ruby on Rails. Links to other Airbrake libraries are in the ReadMe.
Ruby Cucumber HTML

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
features
gemfiles
generators/airbrake
lib
rails
resources
script
test
.gitignore
.yardopts
Appraisals
CHANGELOG
Gemfile
Gemfile.lock
Guardfile
INSTALL
LICENSE
README.md
README_FOR_HEROKU_ADDON.md
Rakefile
TESTED_AGAINST
airbrake.gemspec
circle.yml
install.rb

README.md

Airbrake

This is the notifier gem for integrating apps with Airbrake.

When an uncaught exception occurs, Airbrake will POST the relevant data to the Airbrake server specified in your environment.

Help

For help with using Airbrake and this notifier visit our support site.

For SSL verification see the Resources.

Rails Installation

Rails 3.x

Add the airbrake gem to your Gemfile. In Gemfile:

gem 'airbrake'

Then from your project's RAILS_ROOT, and in your development environment, run:

bundle install
rails generate airbrake --api-key your_key_here

That's it!

The generator creates a file under config/initializers/airbrake.rb configuring Airbrake with your API key. This file should be checked into your version control system so that it is deployed to your staging and production environments.

The default behaviour of the gem is to only operate in Rails environments that are NOT development, test & cucumber.

You can change this by altering this array:

config.development_environments = ["development", "test", "cucumber", "custom"]

Set it to empty array and it will report errors on all environments.

Rails 2.x

Add the airbrake gem to your app. In config/environment.rb:

config.gem 'airbrake'

or if you are using bundler:

gem 'airbrake', :require => 'airbrake/rails'

Then from your project's RAILS_ROOT, and in your development environment, run:

rake gems:install
rake gems:unpack GEM=airbrake
script/generate airbrake --api-key your_key_here

As always, if you choose not to vendor the airbrake gem, make sure every server you deploy to has the gem installed or your application won't start.

The generator creates a file under config/initializers/airbrake.rb configuring Airbrake with your API key. This file should be checked into your version control system so that it is deployed to your staging and production environments.

Supported frameworks

See TESTED_AGAINST for a full list of frameworks and versions we test against.

Airbrake wiki pages

Our wiki contains a lot of additional information about Airbrake configuration. Please browse the wiki when finished reading this README:

https://github.com/airbrake/airbrake/wiki

Development

We use Appraisals to run the tests.

To run the test suite on your machine, you need to run the following commands:

bundle
bundle exec rake appraisal:install

After this, you're ready to run the suite with:

bundle exec rake

This will include cucumber features we use to fully test the integration.

Credits

thoughtbot

Airbrake is maintained and funded by airbrake.io.

Thank you to all the contributors!

The names and logos for Airbrake, thoughtbot are trademarks of their respective holders.

License

Airbrake is Copyright © 2008-2013 Airbrake.

Something went wrong with that request. Please try again.