Sentry Python 安装配置指南：错误监控、性能追踪与日志记录

sentry-python-setup by getsentry/sentry-agent-skills

102 周安装量

19 GitHub Stars

GitHub

安装命令

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

Python Web框架开发运维监控

🇨🇳中文介绍

Sentry Python 设置

在 Python 项目中安装和配置 Sentry。

何时调用此技能

用户要求“在 Python 中添加 Sentry”或在 Python 应用中“安装 Sentry”
用户希望在 Python 中进行错误监控、日志记录或追踪
用户提到 "sentry-sdk" 或 Python 框架（Django, Flask, FastAPI）

重要提示： 下面的配置选项和代码示例仅供参考。在实施前，请务必查阅 docs.sentry.io 进行核实，因为 API 和默认值可能已发生变化。

安装

pip install sentry-sdk

配置

在您的应用程序中尽可能早地初始化：

import sentry_sdk

sentry_sdk.init(
    dsn="YOUR_SENTRY_DSN",
    send_default_pii=True,

    # 追踪
    traces_sample_rate=1.0,

    # 性能剖析
    profile_session_sample_rate=1.0,
    profile_lifecycle="trace",

    # 日志
    enable_logs=True,
)

异步应用程序

对于异步应用，请在异步函数内部初始化：

import asyncio
import sentry_sdk

async def main():
    sentry_sdk.init(
        dsn="YOUR_SENTRY_DSN",
        send_default_pii=True,
        traces_sample_rate=1.0,
        enable_logs=True,
    )
    # ... 应用程序其余部分

asyncio.run(main())

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

框架	初始化位置	备注
Django	`settings.py` 文件顶部	自动检测 Django，无需额外安装
Flask	在 `app = Flask(__name__)` 之前	自动检测 Flask
FastAPI	在 `app = FastAPI()` 之前	自动检测 FastAPI
Celery	在 Celery worker 配置中	自动检测 Celery
AIOHTTP	在应用创建之前	自动检测 AIOHTTP

选项	描述	默认值	最低 SDK 版本
`dsn`	Sentry DSN	`None` (没有它 SDK 将不执行操作)	—
`send_default_pii`	包含用户数据	`None`	—
`traces_sample_rate`	被追踪事务的百分比	`None` (追踪已禁用)	—
`profile_session_sample_rate`	被剖析会话的百分比	`None` (性能剖析已禁用)	2.24.1+
`profile_lifecycle`	性能剖析模式 (`"trace"` 或 `"manual"`)	`"manual"`	2.24.1+
`enable_logs`	将日志发送到 Sentry	`False`	2.35.0+
`environment`	环境名称	`"production"` (或 `SENTRY_ENVIRONMENT` 环境变量)	—
`release`	发布版本	自动检测	—

问题	解决方案
错误未出现	确保 `init()` 被尽早调用，检查 DSN
没有追踪数据	设置 `traces_sample_rate` > 0
IPython 错误未被捕获	从文件运行，而非交互式 shell
异步错误缺失	在异步函数内部初始化

🇺🇸English

Sentry Python Setup

Install and configure Sentry in Python projects.

Invoke This Skill When

User asks to "add Sentry to Python" or "install Sentry" in a Python app
User wants error monitoring, logging, or tracing in Python
User mentions "sentry-sdk" or Python frameworks (Django, Flask, FastAPI)

Important: The configuration options and code samples below are examples. Always verify against docs.sentry.io before implementing, as APIs and defaults may have changed.

Install

pip install sentry-sdk

Configure

Initialize as early as possible in your application:

import sentry_sdk

sentry_sdk.init(
    dsn="YOUR_SENTRY_DSN",
    send_default_pii=True,
    
    # Tracing
    traces_sample_rate=1.0,
    
    # Profiling
    profile_session_sample_rate=1.0,
    profile_lifecycle="trace",
    
    # Logs
    enable_logs=True,
)

Async Applications

For async apps, initialize inside an async function:

import asyncio
import sentry_sdk

async def main():
    sentry_sdk.init(
        dsn="YOUR_SENTRY_DSN",
        send_default_pii=True,
        traces_sample_rate=1.0,
        enable_logs=True,
    )
    # ... rest of app

asyncio.run(main())

Framework Integrations

Use the same sentry_sdk.init() call shown above. Place it where it runs before your app starts:

Framework	Where to Init	Notes
Django	Top of `settings.py`	Auto-detects Django, no extra install
Flask	Before `app = Flask(__name__)`	Auto-detects Flask
FastAPI	Before `app = FastAPI()`	Auto-detects FastAPI
Celery	In Celery worker config	Auto-detects Celery
AIOHTTP	Before app creation	Auto-detects AIOHTTP

Configuration Options

Option	Description	Default	Min SDK
`dsn`	Sentry DSN	`None` (SDK no-ops without it)	—
`send_default_pii`	Include user data	`None`	—
`traces_sample_rate`	% of transactions traced	`None` (tracing disabled)

Environment Variables

The SDK auto-reads these:

SENTRY_DSN=https://xxx@o123.ingest.sentry.io/456
SENTRY_ENVIRONMENT=production
SENTRY_RELEASE=1.0.0

For sentry-cli (source maps, releases), also set:

SENTRY_AUTH_TOKEN=sntrys_xxx
SENTRY_ORG=my-org
SENTRY_PROJECT=my-project

Or pass DSN in code:

import os
import sentry_sdk

sentry_sdk.init(
    dsn=os.environ.get("SENTRY_DSN"),
    # ...
)

Verification

# Intentional error to test
division_by_zero = 1 / 0

Or capture manually:

sentry_sdk.capture_message("Test message from Python")

Troubleshooting

Issue	Solution
Errors not appearing	Ensure `init()` is called early, check DSN
No traces	Set `traces_sample_rate` > 0
IPython errors not captured	Run from file, not interactive shell
Async errors missing	Initialize inside async function

Weekly Installs

102

Repository

getsentry/sentr…t-skills

GitHub Stars

First Seen

Jan 21, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode85

codex82

claude-code82

gemini-cli78

github-copilot73

cursor72