Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fastmonkeys/sentry-on-heroku

Sentry on Heroku
https://github.com/fastmonkeys/sentry-on-heroku

Last synced: about 1 month ago
JSON representation

Sentry on Heroku

Awesome Lists containing this project

README

        

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.

.. _Sentry: https://github.com/getsentry/sentry

Quick setup
-----------

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

.. image:: https://www.herokucdn.com/deploy/button.png
:target: https://heroku.com/deploy
:alt: 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!

.. _release phase: https://devcenter.heroku.com/articles/release-phase

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 [email protected]