Sentry Python SDK

Common errors

Warnings

Install

Install compatibility verified last tested: 2026-05-12

Imports

• sentry_sdk.init
  wrong

  # v1 Hub pattern — Hub removed in v2
  from sentry_sdk import Hub
  with Hub.current.configure_scope() as scope:
      scope.set_tag('key', 'val')  # AttributeError: Hub removed
  
  # enable_tracing deprecated
  sentry_sdk.init(dsn='...', enable_tracing=True)
  
  # Missing traces_sample_rate — no performance data sent
  sentry_sdk.init(dsn='...')  # errors only, no traces

  correct

  import sentry_sdk
  
  sentry_sdk.init(
      dsn='https://KEY@oNNN.ingest.sentry.io/PROJECT_ID',
      traces_sample_rate=1.0,   # 0.0-1.0 — required for performance
      environment='production',
      release='myapp@1.0.0',
      send_default_pii=False,   # do not send PII by default
  )
  
  # Capture exceptions
  try:
      1 / 0
  except ZeroDivisionError:
      sentry_sdk.capture_exception()
  
  # Capture message
  sentry_sdk.capture_message('Something happened', level='warning')
  
  # Add context
  with sentry_sdk.new_scope() as scope:
      scope.set_tag('component', 'checkout')
      scope.set_user({'id': '123', 'email': 'user@example.com'})
      sentry_sdk.capture_exception()

  Hub class removed in v2.0. Use sentry_sdk.new_scope() or sentry_sdk.push_scope(). enable_tracing deprecated — use traces_sample_rate=1.0.

• Framework integrations
  wrong

  # Wrong: integrations auto-detected in v1 but must be explicit in some cases
  # Wrong: passing string names instead of instances
  sentry_sdk.init(
      dsn='...',
      integrations=['fastapi', 'celery']  # TypeError
  )

  correct

  import sentry_sdk
  from sentry_sdk.integrations.fastapi import FastApiIntegration
  from sentry_sdk.integrations.sqlalchemy import SqlalchemyIntegration
  from sentry_sdk.integrations.celery import CeleryIntegration
  
  sentry_sdk.init(
      dsn='https://KEY@oNNN.ingest.sentry.io/PROJECT_ID',
      traces_sample_rate=0.1,  # 10% of transactions
      integrations=[
          FastApiIntegration(),
          SqlalchemyIntegration(),
          CeleryIntegration(),
      ]
  )

  Integrations must be imported and instantiated. Many are auto-detected but explicitly passing them ensures correct configuration.

Quickstart stale last tested: 2026-04-23

Sentry Python SDK — error capture, context, and performance tracing.

# pip install sentry-sdk
import sentry_sdk

sentry_sdk.init(
    dsn='https://KEY@oNNN.ingest.sentry.io/PROJECT_ID',
    traces_sample_rate=1.0,
    environment='production',
    release='1.0.0',
    before_send=lambda event, hint: event  # return None to drop event
)

# Automatic exception capture — unhandled exceptions sent automatically

# Manual exception capture
try:
    result = 1 / 0
except Exception as e:
    sentry_sdk.capture_exception(e)

# Add user context
sentry_sdk.set_user({'id': '42', 'email': 'user@example.com'})

# Add tags
sentry_sdk.set_tag('payment_provider', 'razorpay')

# Add extra data
sentry_sdk.set_extra('order_id', 'ord_123')

# Breadcrumbs
sentry_sdk.add_breadcrumb(
    category='auth',
    message='User logged in',
    level='info'
)

# Performance tracing
with sentry_sdk.start_transaction(op='task', name='process_order'):
    with sentry_sdk.start_span(op='db', description='fetch order'):
        pass  # your DB call here