Add Bugsnag to your Rack based projects.
Add the bugsnag Ruby gem to your Gemfile:
gem 'bugsnag'
Don’t forget to run bundle install after updating your Gemfile.
To identify your app in the Bugsnag dashboard, you’ll need to configure your Bugsnag API key. You can find your API key when creating a project in your Bugsnag dashboard, or later from your project settings page.
To set your API key in your Rack app, add the following code to your config.ru file:
require 'bugsnag'
Bugsnag.configure do |config|
config.api_key = 'YOUR_API_KEY_HERE'
end
Alternatively, you can set the BUGSNAG_API_KEY environment variable.
If you’d like to configure Bugsnag further, check out the configuration options reference.
To automatically capture unhandled exceptions, you’ll need to enable the Bugsnag Rack middleware:
use Bugsnag::Rack
At this point, Bugsnag should be installed and configured, and any unhandled exceptions will be automatically detected and should appear in your Bugsnag dashboard.
Reporting handled exceptions can be accomplished as follows:
begin
raise 'Something went wrong!'
rescue => exception
Bugsnag.notify(exception)
end
It can often be helpful to adjust the severity or attach custom diagnostics to handled exceptions. For more information, see reporting handled errors.
As well as a full stacktrace for every exception, Bugsnag will automatically capture the following diagnostic data:
In order to quickly reproduce and fix errors, it is often helpful to send additional application-specific diagnostic data to Bugsnag. This can be accomplished using a before notify callback as follows:
Bugsnag.before_notify_callbacks << lambda {|notification|
notification.add_tab(:diagnostics, {
product: current_product.name
})
}
For more information, see the customizing error reports reference.
In order to correlate errors with customer reports, or to see a list of users who experienced each error, it is helpful to capture and display user information on your Bugsnag dashboard.
You can set this information using a before notify callback as follows:
Bugsnag.before_notify_callbacks << lambda {|notification|
notification.user = {
email: current_user.email,
name: current_user.name,
id: current_user.id
}
}
For more information, see reporting handled errors.
By sending your source revision or application version to us when you deploy a new version of your app, you’ll be able to see which deploy each error was introduced in, or seen in.
If you are using Capistrano, notify Bugsnag of your deploys by adding our integration to your Capfile:
require 'bugsnag/capistrano'
set :bugsnag_api_key, 'api_key_here'
If you are using a deployment system other than Capistrano, see our deploy tracking guide.
Catch and report errors in your client-side JavaScript with the Web browser JavaScript guide