heroku dev center
RuntimeError

This add-on is operated by Devels Advocates LLP

Track and manage your runtime errors directly in Github

RuntimeError

Last Updated: 05 February 2014

The RuntimeError add-on is currently in beta.

Table of Contents

RuntimeError is an add-on for tracking and managing your runtime errors directly in Github.

Track errors in your web application. Your team is notified when errors happen. Manage your errors from your existing project management tools. Don’t waste time recreating bug reports.

1. Provisioning the add-on

RuntimeError can be attached to a Heroku application via the CLI:

    $ heroku addons:add runtimeerror:test
    -----> Adding runtimeerror to sharp-mountain-4005... done, v18 (test)

Once RuntimeError has been added a RUNTIMEERROR_EMAIL setting will be available in the app configuration and will contain the runtimeerror email is used to route errors to the correct the Github project. This can be confirmed using the heroku config:get command.

    $ heroku config:get RUNTIMEERROR_EMAIL
    hero+ku+hello-world@runtimeerror.net
IMPORTANT STEP: Click through from your app dashboard in heroku.com, into RuntimeError add-on, and choose your Github project.

Your application is now configured to fully integrate with the add-on.

2. Installing

Rails

Add the following entry into Gemfile

    gem 'runtimeerror_notifier'

Update application dependencies with bundler.

    $ bundle install

Finally, initialize the project with a standard config

  1. Either using the rails generator,
    rails generate runtimeerror_notifier:install
  1. Or by manually creating config/initializers/runtimeerror_notifier.rb file with the content below
  if defined?(RuntimeerrorNotifier)
    RuntimeerrorNotifier.for ENV['RUNTIMEERROR_EMAIL']
    RuntimeerrorNotifier::Notifier::IGNORED_EXCEPTIONS.push(*%w[
      ActionController::RoutingError
    ])
  end

Migrating between plans

This section will be updated when we do have plans

Removing the add-on

RuntimeError can be removed via the CLI.

This will destroy all associated data and cannot be undone!
    $ heroku addons:remove runtimeerror:test
    -----> Removing runtimeerror from sharp-mountain-4005... done, v20 (test)

Support

All RuntimeError support and runtime issues should be submitted to RuntimeError Support