用途:为 Python 项目接入 Sentry,覆盖错误监控、追踪、性能分析、日志、指标、Crons 与 AI 监控。适用于 Django、Flask、FastAPI、Starlette、AIOHTTP、Tornado、Quart、Falcon、Pyramid、Sanic、Bottle 等框架,以及 Celery、RQ、Huey、ARQ 等任务队列。
主要能力:先扫描 requirements.txt、pyproject.toml 等文件,检测已有 Sentry、Web 框架、任务队列、日志库、AI 库、调度器与 OpenTelemetry;再给出推荐方案并逐项引导配置。错误监控为基线,日志默认捕获标准库 logging,检测到 HTTP 框架时推荐追踪,检测到 OpenAI/Anthropic/LangChain 等时推荐 AI 监控。若检测到 OTel 追踪,则改用 OTLP 路径,不设置 traces_sample_rate。
使用方式:安装核心 SDK 用 pip install sentry-sdk,按框架可选安装 extras,如 pip install "sentry-sdk[django]"、"sentry-sdk[flask]"、"sentry-sdk[fastapi]"、"sentry-sdk[celery]"。在应用或框架代码之前调用 sentry_sdk.init(),传入 dsn、environment、release、traces_sample_rate、profile_session_sample_rate、profile_lifecycle、enable_logs 等参数。各框架初始化位置不同:Django 在 settings.py 顶部,Flask/FastAPI 在创建 app 之前,Sanic 在 before_server_start 监听器内,Celery 需在 worker 与调用进程双端初始化。多数集成在安装对应包后自动启用。
验证与限制:可用 1/0 或 sentry_sdk.capture_message 验证事件是否上报;无事件时设 debug=True 并检查 DSN 与环境变量。性能分析需 traces_sample_rate 大于 0,且与 OTLP 路径不兼容;enable_logs 需 SDK 2.35.0 及以上。SDK 版本与 API 以官方文档为准,实施前应核对 docs.sentry.io/platforms/python/。