Skip to content
Sentry on Heroku
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
.travis.yml
Procfile
README.rst
app.json
requirements.in
requirements.txt
runtime.txt
sentry.conf.py
uwsgi.ini

README.rst

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.

Deploy

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
    
You can’t perform that action at this time.