sentry-python-sdk

Q: How do I install sentry-python-sdk?

Run npx skills add https://github.com/getsentry/sentry-agent-skills --skill sentry-python-sdk in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/sentry-python-sdk/ (personal) or .claude/skills/sentry-python-sdk/ (project).

by getsentry OfficialDevOps & Cloud

Full Sentry SDK setup for Python. Use when asked to "add Sentry to Python", "install sentry-sdk", "setup Sentry in Python", or configure error monitoring, tracing, profiling, logging, metrics, crons, or AI monitoring for Python applications. Supports Django, Flask, FastAPI, Celery, Starlette, AIOHTTP, Tornado, and more.

Installs: 378
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/getsentry/sentry-agent-skills --skill sentry-python-sdk

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads sentry-python-sdk automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Sentry Python SDK

Opinionated wizard that scans your Python project and guides you through complete Sentry setup.

Invoke This Skill When

User asks to "add Sentry to Python" or "setup Sentry" in a Python app
User wants error monitoring, tracing, profiling, logging, metrics, or crons in Python
User mentions sentry-sdk, sentry_sdk, or Sentry + any Python framework
User wants to monitor Django views, Flask routes, FastAPI endpoints, Celery tasks, or scheduled jobs

Note: SDK versions and APIs below reflect Sentry docs at time of writing (sentry-sdk 2.x). Always verify against docs.sentry.io/platforms/python/ before implementing.

Phase 1: Detect

Run these commands to understand the project before making recommendations:

# Check existing Sentry
grep -i sentry requirements.txt pyproject.toml setup.cfg setup.py 2>/dev/null

# Detect web framework
grep -rE "django|flask|fastapi|starlette|aiohttp|tornado|quart|falcon|sanic|bottle" \
  requirements.txt pyproject.toml 2>/dev/null

# Detect task queues
grep -rE "celery|rq|huey|arq|dramatiq" requirements.txt pyproject.toml 2>/dev/null

# Detect logging libraries
grep -E "loguru" requirements.txt pyproject.toml 2>/dev/null

# Detect AI libraries
grep -rE "openai|anthropic|langchain|huggingface|google-genai|pydantic-ai|litellm" \
  requirements.txt pyproject.toml 2>/dev/null

# Detect schedulers / crons
grep -rE "celery|apscheduler|schedule|crontab" requirements.txt pyproject.toml 2>/dev/null

# Check for companion frontend
ls frontend/ web/ client/ ui/ static/ templates/ 2>/dev/null

What to note:

Is sentry-sdk already in requirements? If yes, check if sentry_sdk.init() is present — may just need feature config.
Which framework? (Determines where to place sentry_sdk.init().)
Which task queue? (Celery needs dual-process init; RQ needs a settings file.)
AI libraries? (OpenAI, Anthropic, LangChain are auto-instrumented.)
Companion frontend? (Triggers Phase 4 cross-link.)

Phase 2: Recommend

Based on what you found, present a concrete proposal. Don't ask open-ended questions — lead with a recommendation:

Always recommended (core coverage):

✅ Error Monitoring — captures unhandled exceptions, supports ExceptionGroup (Python 3.11+)
✅ Logging — Python logging stdlib auto-captured; enhanced if Loguru detected

Recommend when detected:

✅ Tracing — HTTP framework detected (Django/Flask/FastAPI/etc.)
✅ AI Monitoring — OpenAI/Anthropic/LangChain/etc. detected (auto-instrumented, zero config)
⚡ Profiling — production apps where performance matters
⚡ Crons — Celery Beat, APScheduler, or cron patterns detected
⚡ Metrics — business KPIs, SLO tracking

Recommendation matrix:

Feature	Recommend when...	Reference
Error Monitoring	Always — non-negotiable baseline	`${SKILL_ROOT}/references/error-monitoring.md`
Tracing	Django/Flask/FastAPI/AIOHTTP/etc. detected	`${SKILL_ROOT}/references/tracing.md`
Profiling	Production + performance-sensitive workload	`${SKILL_ROOT}/references/profiling.md`
Logging	Always (stdlib); enhanced for Loguru	`${SKILL_ROOT}/references/logging.md`
Metrics	Business events or SLO tracking needed	`${SKILL_ROOT}/references/metrics.md`
Crons	Celery Beat, APScheduler, or cron patterns	`${SKILL_ROOT}/references/crons.md`
AI Monitoring	OpenAI/Anthropic/LangChain/etc. detected	`${SKILL_ROOT}/references/ai-monitoring.md`

Propose: "I recommend Error Monitoring + Tracing [+ Logging if applicable]. Want Profiling, Crons, or AI Monitoring too?"

Phase 3: Guide

Install

# Core SDK (always required)
pip install sentry-sdk

# Optional extras (install only what matches detected framework):
pip install "sentry-sdk[django]"
pip install "sentry-sdk[flask]"
pip install "sentry-sdk[fastapi]"
pip install "sentry-sdk[celery]"
pip install "sentry-sdk[aiohttp]"
pip install "sentry-sdk[tornado]"

# Multiple extras:
pip install "sentry-sdk[django,celery]"

Extras are optional — plain sentry-sdk works for all frameworks. Extras install complementary packages.

Quick Start — Recommended Init

Full init enabling the most features with sensible defaults. Place before any app/framework code:

import sentry_sdk

sentry_sdk.init(
    dsn=os.environ["SENTRY_DSN"],
    environment=os.environ.get("SENTRY_ENVIRONMENT", "production"),
    release=os.environ.get("SENTRY_RELEASE"),   # e.g. "myapp@1.0.0"
    send_default_pii=True,

    # Tracing (lower to 0.1–0.2 in high-traffic production)
    traces_sample_rate=1.0,

    # Profiling — continuous, tied to active spans
    profile_session_sample_rate=1.0,
    profile_lifecycle="trace",

    # Structured logs (SDK ≥ 2.35.0)
    enable_logs=True,
)

Where to Initialize Per Framework

Framework	Where to call `sentry_sdk.init()`	Notes
Django	Top of `settings.py`, before any imports	No middleware needed — Sentry patches Django internally
Flask	Before `app = Flask(__name__)`	Must precede app creation
FastAPI	Before `app = FastAPI()`	`StarletteIntegration` + `FastApiIntegration` auto-enabled together
Starlette	Before `app = Starlette(...)`	Same auto-integration as FastAPI
AIOHTTP	Module level, before `web.Application()`
Tornado	Module level, before app setup	No integration class needed
Quart	Before `app = Quart(__name__)`
Falcon	Module level, before `app = falcon.App()`
Sanic	Inside `@app.listener("before_server_start")`	Sanic's lifecycle requires async init
Celery	`@signals.celeryd_init.connect` in worker AND in calling process	Dual-process init required
RQ	`mysettings.py` loaded by worker via `rq worker -c mysettings`
ARQ	Both worker module and enqueuing process

Django example (settings.py):

import sentry_sdk

sentry_sdk.init(
    dsn=os.environ["SENTRY_DSN"],
    send_default_pii=True,
    traces_sample_rate=1.0,
    profile_session_sample_rate=1.0,
    profile_lifecycle="trace",
    enable_logs=True,
)

# rest of Django settings...
INSTALLED_APPS = [...]

FastAPI example (main.py):

import sentry_sdk

sentry_sdk.init(
    dsn=os.environ["SENTRY_DSN"],
    send_default_pii=True,
    traces_sample_rate=1.0,
    profile_session_sample_rate=1.0,
    profile_lifecycle="trace",
    enable_logs=True,
)

from fastapi import FastAPI
app = FastAPI()

Auto-Enabled vs Explicit Integrations

Most integrations activate automatically when their package is installed — no integrations=[...] needed:

Auto-enabled	Explicit required
Django, Flask, FastAPI, Starlette, AIOHTTP, Tornado, Quart, Falcon, Sanic, Bottle	`DramatiqIntegration`
Celery, RQ, Huey, ARQ	`GRPCIntegration`
SQLAlchemy, Redis, asyncpg, pymongo	`StrawberryIntegration`
Requests, HTTPX, aiohttp-client	`AsyncioIntegration`
OpenAI, Anthropic, LangChain, Pydantic AI, MCP	`OpenTelemetryIntegration`
Python `logging`, Loguru	`WSGIIntegration` / `ASGIIntegration`

For Each Agreed Feature

Walk through features one at a time. Load the reference, follow its steps, verify before moving on:

Feature	Reference file	Load when...
Error Monitoring	`${SKILL_ROOT}/references/error-monitoring.md`	Always (baseline)
Tracing	`${SKILL_ROOT}/references/tracing.md`	HTTP handlers / distributed tracing
Profiling	`${SKILL_ROOT}/references/profiling.md`	Performance-sensitive production
Logging	`${SKILL_ROOT}/references/logging.md`	Always; enhanced for Loguru
Metrics	`${SKILL_ROOT}/references/metrics.md`	Business KPIs / SLO tracking
Crons	`${SKILL_ROOT}/references/crons.md`	Scheduler / cron patterns detected
AI Monitoring	`${SKILL_ROOT}/references/ai-monitoring.md`	AI library detected

For each feature: Read ${SKILL_ROOT}/references/<feature>.md, follow steps exactly, verify it works.

Configuration Reference

Key `sentry_sdk.init()` Options

Option	Type	Default	Purpose
`dsn`	`str`	`None`	SDK disabled if empty; env: `SENTRY_DSN`
`environment`	`str`	`"production"`	e.g., `"staging"`; env: `SENTRY_ENVIRONMENT`
`release`	`str`	`None`	e.g., `"myapp@1.0.0"`; env: `SENTRY_RELEASE`
`send_default_pii`	`bool`	`False`	Include IP, headers, cookies, auth user
`traces_sample_rate`	`float`	`None`	Transaction sample rate; `None` disables tracing
`traces_sampler`	`Callable`	`None`	Custom per-transaction sampling (overrides rate)
`profile_session_sample_rate`	`float`	`None`	Continuous profiling session rate
`profile_lifecycle`	`str`	`"manual"`	`"trace"` = auto-start profiler with spans
`profiles_sample_rate`	`float`	`None`	Transaction-based profiling rate
`enable_logs`	`bool`	`False`	Send logs to Sentry (SDK ≥ 2.35.0)
`sample_rate`	`float`	`1.0`	Error event sample rate
`attach_stacktrace`	`bool`	`False`	Stack traces on `capture_message()`
`max_breadcrumbs`	`int`	`100`	Max breadcrumbs per event
`debug`	`bool`	`False`	Verbose SDK debug output
`before_send`	`Callable`	`None`	Hook to mutate/drop error events
`before_send_transaction`	`Callable`	`None`	Hook to mutate/drop transaction events
`ignore_errors`	`list`	`[]`	Exception types or regex patterns to suppress
`auto_enabling_integrations`	`bool`	`True`	Set `False` to disable all auto-detection

Environment Variables

Variable	Maps to	Notes
`SENTRY_DSN`	`dsn`
`SENTRY_RELEASE`	`release`	Also auto-detected from git SHA, Heroku, CircleCI, CodeBuild, GAE
`SENTRY_ENVIRONMENT`	`environment`
`SENTRY_DEBUG`	`debug`

Verification

Test that Sentry is receiving events:

# Trigger a real error event — check dashboard within seconds
division_by_zero = 1 / 0

Or for a non-crashing check:

sentry_sdk.capture_message("Sentry Python SDK test")

If nothing appears:

Set debug=True in sentry_sdk.init() — prints SDK internals to stdout
Verify the DSN is correct
Check SENTRY_DSN env var is set in the running process
For Celery/RQ: ensure init runs in the worker process, not just the calling process

Phase 4: Cross-Link

After completing Python setup, check for a companion frontend missing Sentry:

ls frontend/ web/ client/ ui/ 2>/dev/null
cat frontend/package.json web/package.json client/package.json 2>/dev/null \
  | grep -E '"react"|"svelte"|"vue"|"next"|"nuxt"'

If a frontend exists without Sentry, suggest the matching skill:

Frontend detected	Suggest skill
React / Next.js	`sentry-react-sdk`
Svelte / SvelteKit	`sentry-svelte-sdk`
Vue / Nuxt	Use `@sentry/vue` — see docs.sentry.io/platforms/javascript/guides/vue/
Other JS/TS	`sentry-react-sdk` (covers generic browser JS patterns)

Troubleshooting

Issue	Solution
Events not appearing	Set `debug=True`, verify DSN, check env vars in the running process
Malformed DSN error	Format: `https://<key>@o<org>.ingest.sentry.io/<project>`
Django exceptions not captured	Ensure `sentry_sdk.init()` is at the top of `settings.py` before other imports
Flask exceptions not captured	Init must happen before `app = Flask(__name__)`
FastAPI exceptions not captured	Init before `app = FastAPI()`; both `StarletteIntegration` and `FastApiIntegration` auto-enabled
Celery task errors not captured	Must call `sentry_sdk.init()` in the worker process via `celeryd_init` signal
Sanic init not working	Init must be inside `@app.listener("before_server_start")`, not module level
uWSGI not capturing	Add `--enable-threads --py-call-uwsgi-fork-hooks` to uWSGI command
No traces appearing	Verify `traces_sample_rate` is set (not `None`); check that the integration is auto-enabled
Profiling not starting	Requires `traces_sample_rate > 0` + either `profile_session_sample_rate` or `profiles_sample_rate`
`enable_logs` not working	Requires SDK ≥ 2.35.0; for direct structured logs use `sentry_sdk.logger`; for stdlib bridging use `LoggingIntegration(sentry_logs_level=...)`
Too many transactions	Lower `traces_sample_rate` or use `traces_sampler` to drop health checks
Cross-request data leaking	Don't use `get_global_scope()` for per-request data — use `get_isolation_scope()`
RQ worker not reporting	Pass `--sentry-dsn=""` to disable RQ's own Sentry shortcut; init via settings file instead

FAQ

What does the sentry-python-sdk skill do?

How do I install sentry-python-sdk?

Run npx skills add https://github.com/getsentry/sentry-agent-skills --skill sentry-python-sdk in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/sentry-python-sdk/ (personal) or .claude/skills/sentry-python-sdk/ (project).

Which AI agents can use sentry-python-sdk?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is sentry-python-sdk safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains sentry-python-sdk?

It is published by getsentry in getsentry/sentry-agent-skills, and it is an official skill from the maker of the technology it covers. It has 378 recorded installs.

More from getsentry/sentry-agent-skills

View all →

sentry-fix-issues

getsentry/sentry-agent-skills

Find and fix issues from Sentry using MCP. Use when asked to fix Sentry errors, debug production issues, investigate exceptions, or resolve bugs reported in Sentry. Methodically analyzes stack traces, breadcrumbs, traces, and context to identify root causes.

OfficialDevOps & Cloud2.6K installs

sentry-react-setup

getsentry/sentry-agent-skills

Setup Sentry in React apps. Use when asked to add Sentry to React, install @sentry/react, or configure error monitoring, error boundaries, session replay, or browser tracing for React applications.

OfficialDevOps & Cloud1.1K installs

sentry-setup-ai-monitoring

getsentry/sentry-agent-skills

Setup Sentry AI Agent Monitoring in any project. Use when asked to monitor LLM calls, track AI agents, or instrument OpenAI/Anthropic/Vercel AI/LangChain/Google GenAI/Pydantic AI. Detects installed AI SDKs and configures appropriate integrations.

OfficialDevOps & Cloud894 installs

sentry-nextjs-sdk

getsentry/sentry-agent-skills

Full Sentry SDK setup for Next.js. Use when asked to "add Sentry to Next.js", "install @sentry/nextjs", or configure error monitoring, tracing, session replay, logging, profiling, AI monitoring, or crons for Next.js applications. Supports Next.js 13+ with App Router and Pages Router.

OfficialDevOps & Cloud653 installs

sentry-pr-code-review

getsentry/sentry-agent-skills

Review a project's PRs to check for issues detected in code review by Seer Bug Prediction. Use when asked to review or fix issues identified by Sentry in PR comments, or to find recent PRs with Sentry feedback.

OfficialCode Quality & Workflow632 installs

sentry-create-alert

getsentry/sentry-agent-skills

Create Sentry alerts using the workflow engine API. Use when asked to create alerts, set up notifications, configure issue priority alerts, or build workflow automations. Supports email, Slack, PagerDuty, Discord, and other notification actions.

OfficialDevOps & Cloud592 installs

Popular devops & cloud skills

View category →

microsoft-foundry

microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and resources end to end. USE FOR: foundry, azd ai agent, azd provision/deploy, hosted agent scaffold/develop/run/deploy/troubleshoot, prompt agent create, managed harness agent create, GitHub Copilot harness agent, create agent, update agent, add tool to agent, invoke agent, agent insights, evaluate agent, batch eval, continuous eval, continuous monitoring, agent CI/CD, optimize prompt, improve prompt, optimize agent instructions, Agent Optimizer scaffold, dataset curation from traces, deploy model, model fine-tuning (SFT/DPO/RFT), Foundry project, RBAC, role assignment, permissions, quota, capacity, region, deployment failure, AI Services, create Foundry resource, knowledge index, customize deployment, onboard, availability, training-data, grader, distillation, large file upload. DO NOT USE FOR: Azure Functions, App Service, general Azure deploy (use azure-deploy), general Azure prep (use azure

OfficialDevOps & Cloud579.1K installs

azure-diagnostics

microsoft/azure-skills

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe triage. WHEN: debug production issues, troubleshoot app service, app service high CPU, app service deployment failure, troubleshoot container apps, container app 503 or target port mismatch, troubleshoot functions, function telemetry missing or stopped after a config/connection-string change, troubleshoot AKS, VM RDP, Linux SSH, VM black screen, can't connect to VM, reset VM password, NSG or firewall blocking, kubectl cannot connect, kube-system/CoreDNS failures, pod pending, crashloop, node not ready, upgrade failures, analyze logs, KQL, insights, image pull failures, cold start issues, health probe failures, resource health, root cause of errors, troubleshoot event hubs, troubleshoot service bus, messaging SDK error, AMQP connection failure, message lock lost, lock renewal during long-running processing, service bus dead letter.

OfficialDevOps & Cloud569.8K installs

azure-prepare

microsoft/azure-skills

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

OfficialDevOps & Cloud569K installs

azure-ai

microsoft/azure-skills

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.

OfficialDevOps & Cloud568.8K installs

azure-deploy

microsoft/azure-skills

Execute Azure deployments for ALREADY-PREPARED applications that have existing .azure/deployment-plan.md and infrastructure files. DO NOT use this skill when the user asks to CREATE a new application — use azure-prepare instead. This skill runs azd up, azd deploy, terraform apply, and az deployment commands with built-in error recovery. Requires .azure/deployment-plan.md from azure-prepare and validated status from azure-validate. WHEN: "run azd up", "run azd deploy", "execute deployment", "push to production", "push to cloud", "go live", "ship it", "bicep deploy", "terraform apply", "publish to Azure", "launch on Azure". DO NOT USE WHEN: "create and deploy", "build and deploy", "create a new app", "set up infrastructure", "create and deploy to Azure using Terraform" — use azure-prepare for these.

OfficialDevOps & Cloud568.6K installs

azure-validate

microsoft/azure-skills

Pre-deployment validation for Azure readiness. Run deep checks on configuration, infrastructure (Bicep or Terraform), RBAC role assignments, managed identity permissions, and prerequisites before deploying. WHEN: validate my app, check deployment readiness, run preflight checks, verify configuration, check if ready to deploy, validate azure.yaml, validate Bicep, test before deploying, troubleshoot deployment errors, validate Azure Functions, validate function app, validate serverless deployment, verify RBAC roles, check role assignments, review managed identity permissions, what-if analysis, validate Container Apps deployment.

OfficialDevOps & Cloud568K installs

sentry-python-sdk

Install

Install

Describe the task

Review the result

SKILL.md

Sentry Python SDK

Invoke This Skill When

Phase 1: Detect

Phase 2: Recommend

Phase 3: Guide

Install

Quick Start — Recommended Init

Where to Initialize Per Framework

Auto-Enabled vs Explicit Integrations

For Each Agreed Feature

Configuration Reference

Key sentry_sdk.init() Options

Environment Variables

Verification

Phase 4: Cross-Link

Troubleshooting

FAQ

More from getsentry/sentry-agent-skills

Popular devops & cloud skills

Key `sentry_sdk.init()` Options