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.

Quick setup

Click the button below to automatically set up the Sentry in an app running on your Heroku account.

Finally, you need to setup your first user:

heroku run "sentry --config=sentry.conf.py createuser" --app YOURAPPNAME

Manual 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 APP_NAME
   

2. Add PostgresSQL to the application:

   heroku addons:create heroku-postgresql:hobby-dev
   

3. Add Redis to the application:

   heroku addons:create heroku-redis:premium-0
   

4. Set Django's secret key for cryptographic signing and Sentry's shared secret for global administration privileges:

   heroku config:set SECRET_KEY=$(python -c "import base64, os; print(base64.b64encode(os.urandom(40)).decode())")
   

5. Set the absolute URL to the Sentry root directory. The URL should not include a trailing slash. Replace the URL below with your application's URL:

   heroku config:set SENTRY_URL_PREFIX=https://sentry-example.herokuapp.com
   

6. Deploy Sentry to Heroku:

   git push heroku master
   

7. Run Sentry's database migrations:

   heroku run "sentry --config=sentry.conf.py upgrade --noinput"
   

8. Create a user account for yourself:

   heroku run "sentry --config=sentry.conf.py createuser"
   

That's it!

Email notifications

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

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

   heroku addons:create sendgrid
   

   or:

   heroku addons:create mandrill
   

2. Set the reply-to email address for outgoing mail:

   heroku config:set [email protected]