Upgrading from Hoptoad

The old Hoptoad gem is no longer supported. To get all the latest features and fixes, you should upgrade to the latest version of our gem.

Step 1: Uninstall the old Hoptoad notifier

Uninstall the old Hoptoad notifier by removing it from your Gemfile, then run the command:

bundle install

You should also replace references in your app to HoptoadNotifier to Airbrake. For example:

# Old name
HoptoadNotifier.notify(err)

# Current name
Airbrake.notify(err)

Upgrade to the latest version of our gem by updating your Gemfile:

Note: our gem is updated frequently, you can always find the current version on RubyGems or on our GitHub.

gem 'airbrake', '~> 8.3.2'

Then run the update command to update our main gem and the airbrake-ruby gem it uses:

bundle update airbrake airbrake-ruby

Step 2: Regenerate config

Run generate command to overwrite old Airbrake config (make sure to replace PROJECT_ID and API_KEY with your project’s actual values which can be found in your project settings page):

rails generate airbrake PROJECT_ID API_KEY

To overwrite your old config, answer Y when prompted:

$ rails generate airbrake PROJECT_ID API_KEY
    conflict  config/initializers/airbrake.rb
Overwrite /Users/arthur/my-app/config/initializers/airbrake.rb? (enter "h" for help) [Ynaqdhm]

Step 3: Update config

To track Performance Monitoring data, enable the performance_stats option in your config/initializers/airbrake.rb file.

Airbrake.configure do |c|
  # Add the following line to your config:
  c.performance_stats = true
end