Heroku Exception Tracking
Typical installation time: 1 minute
Hi there! You've found Honeybadger's guide to Heroku exception tracking. Once installed, Honeybadger will automatically report exceptions wherever they may happen:
- During a web request
- In a background job
- In a rake task
- When a process crashes (
If you're new to Honeybadger, read our Getting Started guide to become familiar with our Ruby gem. For a refresher on working with exceptions in Ruby, check out the Honeybadger guide to Ruby exceptions.
On this page:
The first step is to add the honeybadger gem to your Gemfile:
Tell bundler to install:
$ bundle install
You can configure Honeybadger on your dynos like so:
Note: This last step isn't necessary if you're using our Heroku add-on, as it adds our API key to your Heroku config automatically.
$ bundle exec honeybadger heroku install [YOUR API KEY HERE]
This will automatically add a
HONEYBADGER_API_KEY environment variable to your
remote Heroku config and configure deploy notifications.
Deploy tracking via Heroku is implemented using Heroku's free deploy hooks addon. If you ran the Installation command already, then you should already have deployment tracking installed. Otherwise, to install the addon and configure it for Honeybadger, run the following CLI command from your project root:
$ bundle exec honeybadger heroku install_deploy_notification
If the honeybadger CLI command fails for whatever reason, you can add the deploy hook manually by running:
$ heroku addons:add deployhooks:http --url="https://api.honeybadger.io/v1/deploys?deploy[environment]=production&deploy[local_username]=&deploy[revision]=&api_key=asdf" --app app-name
You should replace the
app options with your own values. You may
also want to change the environment (set to production by default).