Starlette

The Starlette integration adds support for the Starlette Framework.

Install

Install sentry-sdk from PyPI with the starlette extra:

pip install --upgrade 'sentry-sdk[starlette]'

Configure

If you have the starlette package in your dependencies, the Starlette integration will be enabled automatically when you initialize the Sentry SDK.

from starlette.applications import Starlette
import sentry_sdk

sentry_sdk.init(
    dsn="https://examplePublicKey@o0.ingest.sentry.io/0",
    enable_tracing=True,
)

app = Starlette(routes=[...])

Verify

from starlette.applications import Starlette
from starlette.routing import Route

sentry_sdk.init(...)  # same as above

async def trigger_error(request):
    division_by_zero = 1 / 0

app = Starlette(routes=[
    Route("/sentry-debug", trigger_error),
])

When you point your browser to http://localhost:8000/sentry-debug a transaction will be created in the Performance section of sentry.io. Additionally, an error event will be sent to sentry.io and will be connected to the transaction.

It takes a couple of moments for the data to appear in sentry.io.

Behavior

• All exceptions leading to an Internal Server Error are reported.

• Request data is attached to all events: HTTP method, URL, headers, form data, JSON payloads. Sentry excludes raw bodies and multipart file uploads. Sentry also excludes personally identifiable information (such as user ids, usernames, cookies, authorization headers, IP addresses) unless you set send_default_pii to True.

• If enable_tracing or a traces_sample_rate is set, then performance information is also reported, which you can see on the Performance page of sentry.io.

Options

By adding StarletteIntegration explicitly to your sentry_sdk.init() call you can set options for StarletteIntegration to change its behavior:

from sentry_sdk.integrations.starlette import StarletteIntegration

sentry_sdk.init(
    dsn="https://examplePublicKey@o0.ingest.sentry.io/0",
    enable_tracing=True,
    integrations=[
        StarletteIntegration(
            transaction_style="endpoint",
        )
    ],
)

You can pass the following keyword arguments to StarletteIntegration():

• transaction_style:

  Python

  Copied

  async def product_detail(request):
      return JSONResponse({...})
  
  app = Starlette(routes=[
      Route('/catalog/product/{product_id}', product_detail),
  ])
  

  In the above code, the transaction name will be:

  • "/catalog/product/{product_id}" if you set transaction_style="url".
  • "product_detail" if you set transaction_style="endpoint"

  The default is "url".

Supported Versions

• Starlette: 0.19.1+
• Python: 3.7+