Sentry on Heroku
Pull request Compare This branch is 33 commits ahead, 85 commits behind fastmonkeys:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Sentry on Heroku

Sentry is a realtime event logging and aggregation platform. At its core it specializes in monitoring errors and extracting all the information needed to do a proper post-mortem without any of the hassle of the standard user feedback loop.

Basic setup

Follow the steps below to get Sentry up and running on Heroku:

  1. Create a new Heroku application. Replace "APP_NAME" with your application's name:

    heroku apps:create --stack cedar APP_NAME
  2. Add database to the application:

    heroku addons:add heroku-postgresql:dev
  1. Set the heroku app name (and custom domain if needed)

    heroku config:add HEROKU_APP_NAME='my_app_name' heroku config:add CUSTOM_DOMAIN=''

  1. Set Sentry's shared secret for global administration privileges:

    heroku config:add SENTRY_KEY='0123456789abcde'

    You may use the following Python code to generate a good unique key for the above:

    >>> import base64
    >>> import os
    >>> base64.b64encode(os.urandom(40))
  2. Deploy Sentry to Heroku:

    git push heroku master
  3. Run Sentry's database migrations:

    heroku run "sentry upgrade"
  4. Create a user account for yourself:

    heroku run "sentry createsuperuser"
  5. Restart the app so everything is up-to-date:

    heroku restart

That's it! Open your newly created sentry server: heroku open

Email notifications

Follow the steps below, if you want to enable Sentry's email notifications:

  1. Add SendGrid add-on to your Heroku application:

    heroku addons:add sendgrid
  2. Set the reply-to email address for outgoing mail:

    heroku config:add
  3. Set the email addresses that should be notified:

    heroku config:add,