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. Sentry's database migrations are automatically run as part of the Heroku release phase

   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 SendGrid add-on to your Heroku application:

   heroku addons:create sendgrid
   

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

   heroku config:set SERVER_EMAIL=sentry@example.com