用途:在 Python 应用中接入 Sentry,实现错误监控、日志、追踪与性能分析。适用于用户要求为 Python 添加 Sentry、安装 sentry-sdk,或为 Django、Flask、FastAPI 等框架配置监控的场景。
主要能力:安装 sentry-sdk;通过 sentry_sdk.init() 初始化,支持 DSN、send_default_pii、traces_sample_rate(追踪)、profile_session_sample_rate 与 profile_lifecycle(性能分析)、enable_logs(日志)等选项;支持异步应用在 async 函数内初始化;自动识别 Django、Flask、FastAPI、Celery、AIOHTTP 等框架;支持通过 SENTRY_DSN、SENTRY_ENVIRONMENT、SENTRY_RELEASE 等环境变量自动读取配置,sentry-cli 另需 SENTRY_AUTH_TOKEN、SENTRY_ORG、SENTRY_PROJECT。
使用方式:先执行 pip install sentry-sdk,再在应用启动前尽早调用 sentry_sdk.init()。Django 放在 settings.py 顶部,Flask 放在 app = Flask(name) 之前,FastAPI 放在 app = FastAPI() 之前,Celery 放在 worker 配置中,AIOHTTP 放在应用创建前。异步应用需在 async 函数内初始化。可用 1 / 0 或 sentry_sdk.capture_message() 验证。
限制与注意:资料中的配置选项和代码示例仅为示例,实施前应核对 docs.sentry.io,因为 API 与默认值可能变化;未提供 DSN 时 SDK 不生效;追踪需 traces_sample_rate 大于 0;IPython 交互式环境可能无法捕获错误,应从文件运行;异步错误需在异步函数内初始化。部分选项有最低 SDK 版本要求(如 profile_session_sample_rate、profile_lifecycle 需 2.24.1+,enable_logs 需 2.35.0+)。