用途:为 Python 项目接入 Sentry SDK,覆盖错误监控、追踪、性能分析、日志、指标、Crons 与 AI 监控。适用于用户要求“给 Python 加 Sentry”“安装 sentry-sdk”或监控 Django 视图、Flask 路由、FastAPI 端点、Celery 任务等场景。
主要能力:先扫描项目(grep requirements.txt/pyproject.toml 等)判断是否已装 sentry-sdk、使用何种 Web 框架、任务队列、日志库、AI 库与调度器,再给出具体推荐。错误监控与日志为始终推荐;检测到 HTTP 框架时推荐追踪;检测到 OpenAI/Anthropic/LangChain 等时推荐 AI 监控;性能敏感生产环境可加 Profiling,检测到 Celery Beat/APScheduler 可加 Crons。
使用方式:安装核心包 pip install sentry-sdk,按框架可选 pip install "sentry-sdk[django]" 等 extras。在应用代码前调用 sentry_sdk.init(),常用参数包括 dsn、environment、release、send_default_pii、traces_sample_rate、profile_session_sample_rate、profile_lifecycle、enable_logs。多数集成在安装对应包后自动启用,无需显式 integrations 列表。各框架初始化位置不同:Django 在 settings.py 顶部、Flask/FastAPI 在创建 app 之前、Sanic 在 before_server_start 监听器内、Celery 需在 worker 与调用进程双端初始化。验证可用 1/0 触发错误或 sentry_sdk.capture_message()。
限制:资料基于 sentry-sdk 2.x,实施前应核对官方文档;enable_logs 需 SDK ≥ 2.35.0;Profiling 需 traces_sample_rate > 0;uWSGI 需加 --enable-threads --py-call-uwsgi-fork-hooks;RQ 需通过设置文件初始化。具体收费、价格与平台支持范围资料未提供。