This add-on is operated by Rollbar
Real-time error monitoring, alerting, and analytics for developers.
Last updated 11 September 2017
Table of Contents
Rollbar is an add-on for tracking and reproducing exceptions and errors. We collect, de-duplicate, and alert on error conditions, and provide a dashboard and analysis tools so you can understand, reproduce, and fix errors quickly.
Adding Rollbar to your app means you’ll always know what errors your users are seeing, and you’ll often be able to fix them before users complain.
Provisioning the add-on
A list of all plans available can be found here.
Rollbar can be attached to a Heroku application via the CLI:
$ heroku addons:create rollbar:free
Once Rollbar has been added, a
ROLLBAR_ACCESS_TOKEN setting will be available in the app configuration and will contain your server-side access token. This can be confirmed using the
heroku config:get command.
$ heroku config:get ROLLBAR_ACCESS_TOKEN a1a1b2b2c3c3d4d4e5e5f6f6e7e7d8d8
After installing Rollbar the application should be configured to fully integrate with the add-on.
After provisioning the add-on, it’s necessary to locally replicate the config vars so your development environment can operate against the service.
Though less portable, it’s also possible to set local environment variables using
Use Foreman to configure, run and manage process types specified in your app’s Procfile. Foreman reads configuration variables from an .env file. Use the following command to add the
ROLLBAR_ACCESS_TOKEN values retrieved from heroku config to
$ heroku config -s | grep ROLLBAR_ACCESS_TOKEN >> .env $ more .env
Credentials and other sensitive configuration values should not be committed to source-control. In Git exclude the .env file with:
echo .env >> .gitignore.
For more information, see the Heroku Local article.
For detailed information about how to configure and use the different client libraries, please head over to Rollbar’s docs.
For more information on the features available within the Rollbar dashboard please see the docs at rollbar.com/features.
The dashboard can be accessed via the CLI:
$ heroku addons:open rollbar
or by visiting the Heroku apps web interface and selecting the application in question. Select Rollbar from the Add-ons menu.
Migrating between plans
heroku addons:upgrade command to choose a new plan. This is a downtime-free operation.
$ heroku addons:upgrade rollbar:hobby -----> Upgrading rollbar:small to sharp-mountain-4005... done, v18 ($12.00/mo) Your plan has been updated to: rollbar:hobby
Removing the add-on
Rollbar can be removed via the CLI.
This will destroy all associated data and cannot be undone!
$ heroku addons:destroy rollbar -----> Removing rollbar from sharp-mountain-4005... done, v20 (free)
Before removing Rollbar, a data export can be performed by contacting email@example.com.