Knowledge Base

The system is designed to be very simple to get off the ground, yet powerful to grow into. To start, you'll want to signup for a subscription on

Once you've been setup, you'll be presented with the opportunity to create a team, your first project, and we'll walk you through setting up Sentry in your application.

After you complete setting up a project, you'll be given a value which we call a DSN, or Data Source Name. It looks a lot like a standard URL, but it's actually just a representation of the configuration required by Raven (the Sentry client). It consists of a few pieces, including the protocol, public and secret keys, the server address, and the project identifier.

You'll have a few options for plugging the DSN into the client, depending on what it supports. At the very least, most clients will allow you to set it up as the SENTRY_DSN environment variable or by passing it into the client constructor.

Note: If you're using Heroku, and you've added Sentry via the standard addon hooks, most clients will automatically pick up the SENTRY_DSN environment variable that we've already configured for you.