Sentry
Last updated 19 July 2020
Table of Contents
Sentry is a realtime event logging and aggregation platform. 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.
Provisioning the add-on
Start by adding the Sentry addon:
$ heroku addons:create sentry
Integrating with Ruby (or Rails 3.x)
Add the Raven gem to your Gemfile:
gem 'sentry-raven'
In Rails we will automatically pick up unhandled exceptions and send them to Sentry. For other platforms you can wrap your code to manually log the exceptions:
begin
1 / 0
rescue ZeroDivisionError => exception
Raven.capture_exception(exception)
end
If you’re not running with the “production” environment, you’ll need to manually specify that by calling out to Raven:
Raven.configure do |config|
config.current_environment = 'production'
end
Integrating with Python (or Django)
Sentry configures the integration during library initialization.
import os
import sentry_sdk
sentry_sdk.init(os.environ['SENTRY_DSN'])
If you’re using Django, initialize it with the Django integration in your settings.py file:
import os
import sentry_sdk
from sentry_sdk.integrations.django import DjangoIntegration
sentry_sdk.init(
dsn=os.environ['SENTRY_DSN'],
integrations=[DjangoIntegration()]
)
In any platform, you can explicitly capture an error using the captureException method:
from sentry_sdk import capture_exception
try:
a_potentially_failing_function()
except Exception as e:
# Alternatively the argument can be omitted
capture_exception(e)
If you are just looking to generate a test exception, you can do that via the sentry_sdk CLI:
sentry_sdk test `heroku config:get SENTRY_DSN`
Viewing Sentry
Heroku provides an easy interface for logging into the Sentry web UI:
$ heroku addons:open sentry
Removing the add-on
Just as provisioning, this is done through the addons interface:
$ heroku addons:destroy sentry