We’ve been feasting at the Open Source table without paying the maintainers for too long. The Open Source Pledge is looking to change that. Will you join us?
×

Python Error and Performance Monitoring

Actionable insights to resolve Python performance bottlenecks and errors. See the full picture of any Python exception so you can diagnose, fix, and optimize performance in the Python debugging process.

Grab the Sentry Python SDK:

Copied!Click to Copy
pip install --upgrade sentry-sdk

Configure your DSN:

Copied!Click to Copy
import sentry_sdk

sentry_sdk.init(
    "https://<key>@sentry.io/<project>",

    # Set traces_sample_rate to 1.0 to capture 100%
    # of transactions for Tracing.
    # We recommend adjusting this value in production.
    enable_tracing=True,
    traces_sample_rate=1.0,
)

Getting Started is Simple

Grab the Sentry Python SDK:

Copied!Click to Copy
pip install --upgrade sentry-sdk

Configure your DSN:

Copied!Click to Copy
import sentry_sdk

sentry_sdk.init(
    "https://<key>@sentry.io/<project>",

    # Set traces_sample_rate to 1.0 to capture 100%
    # of transactions for Tracing.
    # We recommend adjusting this value in production.
    enable_tracing=True,
    traces_sample_rate=1.0,
)

Install our Python SDK using pip:

Copied!Click to Copy
pip install --upgrade sentry-sdk

Initialize the Python SDK with the Django integration in your settings.py file.

Copied!Click to Copy
import sentry_sdk
from sentry_sdk.integrations.django import DjangoIntegration

sentry_sdk.init(
    dsn="https://<key>@sentry.io/<project>",
    integrations=[DjangoIntegration()],

    # Set traces_sample_rate to 1.0 to capture 100%
    # of transactions for Tracing.
    # We recommend adjusting this value in production,
    traces_sample_rate=1.0,

    # If you wish to associate users to errors (assuming you are using
    # django.contrib.auth) you may enable sending PII data.
    send_default_pii=True
)

Install sentry-sdk from PyPI with the flask extra:

Copied!Click to Copy
pip install --upgrade 'sentry-sdk[flask]'

Configure your DSN:

Copied!Click to Copy
import sentry_sdk
from flask import Flask
from sentry_sdk.integrations.flask import FlaskIntegration

sentry_sdk.init(
    dsn="https://<key>@sentry.io/<project>",
    integrations=[FlaskIntegration()],

    # Set traces_sample_rate to 1.0 to capture 100%
    # of transactions for Tracing.
    # We recommend adjusting this value in production,
    traces_sample_rate=1.0
)

app = Flask(__name__)

Grab the Sentry Python SDK:

Copied!Click to Copy
pip install --upgrade sentry-sdk

Configure your DSN:

Copied!Click to Copy
from fastapi import FastAPI

import sentry_sdk
sentry_sdk.init(
    dsn="https://<key>@sentry.io/<project>",

    # Set traces_sample_rate to 1.0 to capture 100%
    # of transactions for Tracing.
    # We recommend adjusting this value in production,
    traces_sample_rate=1.0,

    # If you wish to associate users to errors (assuming you are using
    # django.contrib.auth) you may enable sending PII data.
    send_default_pii=True,
)

app = FastAPI()

Install sentry-sdk from PyPI with the bottle extra:

Copied!Click to Copy
pip install --upgrade 'sentry-sdk[bottle]==0.16.2'

To configure the SDK, initialize it with the integration before your app has been initialized:

Copied!Click to Copy
import sentry_sdk

from bottle import Bottle, run
from sentry_sdk.integrations.bottle import BottleIntegration

sentry_sdk.init(
    dsn="https://<key>@sentry.io/<project>",
    integrations=[BottleIntegration()]
)

app = Bottle()

Just add CeleryIntegration() to your integrations list:

Copied!Click to Copy
import sentry_sdk
from sentry_sdk.integrations.celery import CeleryIntegration

sentry_sdk.init(
    dsn='https://<key>@sentry.io/<project>',
    integrations=[CeleryIntegration()]
)

Install sentry-sdk from PyPI:

Copied!Click to Copy
pip install --upgrade sentry-sdk

To configure the SDK, initialize it with the integration before or after your app has been created:

Copied!Click to Copy
import sentry_sdk

from sentry_sdk.integrations.pyramid import PyramidIntegration

sentry_sdk.init(
    dsn="https://<key>@sentry.io/<project>",
    integrations=[PyramidIntegration()]
)

from pyramid.config import Configurator

with Configurator() as config:
    # ...

Install our Python SDK using pip:

Copied!Click to Copy
pip install --upgrade sentry-sdk

Initialize the Python SDK with the Tornado integration in your settings.py file.

Copied!Click to Copy
import sentry_sdk
from sentry_sdk.integrations.tornado import TornadoIntegration

sentry_sdk.init(
    dsn="https://examplePublicKey@o0.ingest.sentry.io/0",
    integrations=[
        TornadoIntegration(),
    ],

    # Set traces_sample_rate to 1.0 to capture 100%
    # of transactions for Tracing.
    # We recommend adjusting this value in production,
    traces_sample_rate=1.0,
)

# Your app code here, without changes

class MyHandler(...):
    # ...

Create a file called mysettings.py with the following content:

Copied!Click to Copy
import sentry_sdk
from sentry_sdk.integrations.rq import RqIntegration

sentry_sdk.init("https://<key>@sentry.io/<project>", integrations=[RqIntegration()])

Start your worker with:

Copied!Click to Copy
rq worker \
-c mysettings \  # module name of mysettings.py
--sentry-dsn=""  # only necessary for RQ < 1.0

Install our Python SDK using pip:

Copied!Click to Copy
pip install --upgrade sentry-sdk

Then use the AWS Lambda integration for the Python SDK like this:

Copied!Click to Copy
import sentry_sdk

sentry_sdk.init(
    dsn="https://<key>@sentry.io/<project>",
    integrations=[AwsLambdaIntegration()],
    traces_sample_rate=1.0, # adjust the sample rate in production as needed
)

def my_function(event, context):
    # ...

Add the Sentry SDK to your requirements.txt:

Copied!Click to Copy
pip install sentry-sdk

Then use the GCP Functions integration for the Python SDK like this:

Copied!Click to Copy
import sentry_sdk
from sentry_sdk.integrations.gcp import GcpIntegration

sentry_sdk.init(
    dsn="https://<key>@sentry.io/<project>",
    integrations=[GcpIntegration()],
    traces_sample_rate=1.0, # adjust the sample rate in production as needed
)

def http_function_entrypoint(request):
    # ...

Check our documentation for the latest instructions.

See All Platforms

How to install the Python SDK

More than 150K Organizations Trust Sentry with Their Application Monitoring

Python Performance Monitoring

Within minutes after installing Sentry, software teams are able to trace Python performance issues back to a poor performing API call as well as surface all related code errors. Engineering Managers and Developers now have a single tool to optimize the performance of their code and deliver fast customer experiences.
See a Sample Transaction

Python Error Monitoring with Complete Stack Traces

See local variables in the stack for prod errors, just like in your dev environment. Introspect more deeply into the runtime and jump into the frame to get additional data for any local variable. Filter and group Python exceptions intuitively to eliminate noise.
See a Sample Stack Trace

Fill In the Blanks About Python Errors

Expose the important events that led to each Python exception: SQL queries, debug logs, network requests, past errors. Improve debugging workflow with a full view of releases so you can mark errors as resolved and prioritize live issues.
Check out Breadcrumbs

Python Profiling

Profiling lets you see what parts of your code are consuming the most resources, like CPU or memory, in your application— so you can optimize them before end user experience is impacted. Test your application performance in any environment, including in production, without writing manual tests or extensive troubleshooting.
Try Profiling

Understand Where Tests Could Prevent Your Python Regressions

Quickly isolate Code Coverage for Python bugs to see where testing could help fix the bug before release with our Codecov integration.
Learn More About Codecov by Sentry

"The time to resolve errors went from days to minutes."

Vaidik Kapoor
VP of Engineering at Grofers
Grofers

Debugging Any Python Exception

Aggregate errors by details like HTTP request, hostname, and app version to see what's new, a priority, or a trend.

Assign custom tags to reproduce the error environment specific to your application, business, and users.

Answer the most important questions: In which app release did the Python bug occur? Was it the kraken?

FAQs

Traditional logging provides you with a trail of events. Some of those events are errors, but many times they're simply informational. Sentry is fundamentally different because we focus on exceptions, or in other words, we capture application crashes. We discuss in more detail here and on our blog.

Sentry supports every major language, framework, and library. You can browse each of them here.

You can get started for free. Pricing depends on the number of monthly events, transactions, and attachments that you send Sentry. For more details, visit our pricing page.

Sentry doesn't impact a web site's performance.

If you look at the configuration options for when you initialize Sentry in your code, you'll see there's nothing regarding minimizing its impact on your app's performance. This is because our team of SDK engineers already developed Sentry with this in mind.

Sentry is a listener/handler for errors that asynchronously sends out the error/event to Sentry.io. This is non-blocking. The error/event only goes out if this is an error.

Global handlers have almost no impact as well, as they are native APIs provided by the browsers.

Supporting Resources

Debugging Python Errors

How Sentry Helps Grofers Meet Unprecedented Delivery Demand

Resolve Python errors with max efficiency, not max effort