PythonPython
On this page, we get you up and running with Sentry's SDK, so that it will automatically report errors and exceptions in your application.
If you don't already have an account and Sentry project established, head over to sentry.io, then return to this page.
Using a framework? Take a look at our specific guides to get started.
Install
Sentry captures data by using an SDK within your application’s runtime:
Install our Python SDK using pip:
pip install --upgrade sentry-sdkConfigure
Configure Sentry as early as possible in your app. Once this is done, the Sentry SDK captures all unhandled exceptions.
Import and initialize the Sentry SDK early in your application's setup:
import sentry_sdk
sentry_sdk.init(
"https://examplePublicKey@o0.ingest.sentry.io/0",
traces_sample_rate=1.0, # We recommend lowering this in production
)We'll automatically assign you a Data Source Name (DSN), which looks like a standard URL. It's required by Sentry and configures the protocol, public key, server address, and project identifier. If you forget it, view Settings -> Projects -> Client Keys (DSN) in sentry.io.
Verify
This snippet includes an intentional error, so you can test that everything is working as soon as you set it up:
One way to verify your setup is by intentionally causing an error that breaks your application.
Raise an unhandled Python exception by inserting a divide by zero expression into your application:
division_by_zero = 1 / 0To view and resolve the recorded error, log into sentry.io and open your project. Clicking on the error's title will open a page where you can see detailed information and mark it as resolved.
- Package:
- pypi:sentry-sdk
- Version:
- 0.18.0
- Repository:
- https://github.com/getsentry/sentry-python