Integrations

Sentry provides additional integrations designed to change configuration or add instrumentation to your application.

The Sentry SDK uses integrations to hook into the functionality of popular libraries to automatically instrument your application and give you the best data out of the box.

Auto-enabled
python.django iconDjango✓
python.flask iconFlask✓
python.fastapi iconFastAPI✓
python.aiohttp iconAIOHTTP✓
python.bottle iconBottle✓
python.falcon iconFalcon✓
python.pyramid iconPyramid✓
python.quart iconQuart✓
python.sanic iconSanic✓
python.starlette iconStarlette✓
python.starlite iconStarlite✓
python.litestar iconLitestar✓
python.tornado iconTornado✓

Auto-enabled
python.asyncpg iconasyncpg✓
python.clickhouse-driver iconClickHouse✓
python.pymongo iconMongoDB✓
python.redis iconRedis✓
python.sqlalchemy iconSQLAlchemy✓

Auto-enabled
anthropic iconAnthropic✓
huggingface iconHuggingface Hub✓
langchain iconLangchain✓
openai iconOpenAI✓

| Auto-enabled | | ------------------------------------------------------------------------------------------------------------------------ | :--------------: | | python.airflow iconApache Airflow| | | python.beam iconApache Beam| | | python.spark iconApache Spark| | | python.arq iconARQ| ✓ | | python.celery iconCelery| ✓ | | python.dramatiq iconDramatiq| | | python.huey iconhuey| ✓ | | python.rq iconRQ| ✓ | | python.ray iconRay| |

Auto-enabled
python.awslambda iconAWS Lambda
python.boto3 iconBoto3✓
python.chalice iconChalice✓
python.cloudresourcecontext iconCloud Resource Context
python.gcpfunctions iconGoogle Cloud Functions
python.serverless iconServerless Framework

Auto-enabled
python.aiohttp iconAIOHTTP✓
python.httpx iconHTTPX✓
Python standard HTTP client (in the Default Integrations)✓
Requests HTTP instrumentation is done via the Default Integrations.✓

Auto-enabled
python.ariadne iconAriadne✓
python.gql iconGQL✓
python.graphene iconGraphene✓
python.strawberry iconStrawberry✓

Auto-enabled
python.grpc icongRPC✓

Auto-enabled
python.logging iconLogging✓
python.loguru iconLoguru✓

Auto-enabled
python.asgi iconASGI
python.asyncio iconasyncio
python.pure_eval iconEnhanced Locals
python.gnu_backtrace iconGNU Backtrace
python.socket iconSocket
python.tryton iconTryton
python.wsgi iconWSGI

Integration
Argv
Atexit
Excepthook
Deduplication
Stdlib
Modules
Logging
Threading

Integrations can be added using the integrations config option.

Integrations marked as "auto-enabled" in the above table will be turned on automatically, unless you set auto_enabling_integrations to False. If you want to configure a specific integration's settings (for instance, change Flask's default transaction_style), add it to your integrations list as you would a non-auto-enabling integration and pass in the desired options.

Copied
import sentry_sdk
from sentry_sdk.integrations.asyncio import AsyncioIntegration
from sentry_sdk.integrations.flask import FlaskIntegration

sentry_sdk.init(
    integrations=[
        # The Flask integration is auto-enabling, but we want to change
        # transaction_style from the default "endpoint" to "url"
        FlaskIntegration(transaction_style="url"),
        # The asyncio integration is not enabled automatically
        # and needs to be added manually.
        AsyncioIntegration(),
    ],
)

To disable an integration, use the disabled_integrations config option:

Copied
import sentry_sdk
from sentry_sdk.integrations.flask import FlaskIntegration

sentry_sdk.init(
    # Do not use the Flask integration even if Flask is installed.
    disabled_integrations=[
        FlaskIntegration(),
    ],
)

It's also possible to disable all automatically-added integrations. There are two types:

  • Auto-enabled integrations like FlaskIntegration are automatically added if the SDK detects that you have a corresponding package (like Flask) installed. This happens when the auto_enabling_integrations option is set to True (default).
  • Default integrations like logging or excepthook are always enabled, regardless of what packages you have installed, as long as the default_integrations option is True (default). They provide essential SDK functionality like error deduplication or event flushing at interpreter shutdown.

To disable all auto-enabling integrations, you can use the auto_enabling_integrations option:

Copied
import sentry_sdk
from sentry_sdk.integrations.flask import FlaskIntegration

sentry_sdk.init(
    # Turn off all auto-enabling integrations except for Flask
    auto_enabling_integrations=False,
    integrations=[
        FlaskIntegration(),
    ],
)

To disable all default integrations, set default_integrations to False. Note that this disables all automatically added integrations, both default and auto-enabling. Any integrations you want to use then have to be manually specified via the integrations config option.

Copied
import sentry_sdk
from sentry_sdk.integrations.atexit import AtexitIntegration
from sentry_sdk.integrations.argv import ArgvIntegration
from sentry_sdk.integrations.dedupe import DedupeIntegration
from sentry_sdk.integrations.excepthook import ExcepthookIntegration
from sentry_sdk.integrations.stdlib import StdlibIntegration
from sentry_sdk.integrations.modules import ModulesIntegration
from sentry_sdk.integrations.threading import ThreadingIntegration

sentry_sdk.init(
    # Turn off the default logging integration, but keep the rest.
    default_integrations=False,
    integrations=[
        AtexitIntegration(),
        ArgvIntegration(),
        DedupeIntegration(),
        ExcepthookIntegration(),
        StdlibIntegration(),
        ModulesIntegration(),
        ThreadingIntegration(),
    ],
)
Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").