用途:指导将 Sentry 错误追踪接入服务,重点在于避免泄露凭证,并让堆栈能关联到具体提交。
主要能力:区分 DSN(只写摄取,可随构建产物分发)与 auth token(全 API,只应放 CI 密钥或钥匙串),指出把 token 提交到仓库属于事故。说明内置 EventScrubber 默认开启,仅按 32 个键名匹配、不检查字符串值,因此 URL 中的凭证(如 postgresql://u:SECRET@host/db)不会被清除;建议双层防护:第一层用 EventScrubber(denylist=DEFAULT_DENYLIST + 额外键, recursive=True),第二层用 before_send 正则清除值,并配测试断言仅靠第一层仍会泄露,同时设 send_default_pii=False。
使用方式:先检查是否已认证,命令如 sentry auth status、sentry org list --json、sentry project list --json;获取已有项目的 DSN 用 sentry project view <org>/<project> --json 配合 python3 解析。首次接入参考 references/setup.md。发布需让 SDK 的 release 与 sentry release create/set-commits/deploy 使用同一版本串(如 Heroku 的 HEROKU_SLUG_COMMIT),否则问题会挂到无提交的发布上,可疑提交归因失效;发布记账失败不应中断部署。MCP 地址 https://mcp.sentry.dev/mcp 返回 401 且带 www-authenticate: Bearer realm="OAuth",属 OAuth 上游,只能声明在智能体自身配置中,不能放在共享网关。
限制:sentry 与 sentry-cli 是两个不同工具,混用会浪费排查时间,需每仓库选定其一并写明。sentry project create 可能因组织策略 allowMemberProjectCreation: false 及 token 缺 org:write/org:admin 而报“组织已禁用此功能”,需改用网页创建、改组织设置或使用 Internal Integration token。无 CLI 时可用 REST API 或网页;无 MCP 不损失能力,可用 sentry issue list。凭证缺失属人工步骤,应说明被阻塞项后继续。健康状态需区分 liveness、readiness 与 degraded_auth,瞬时认证失败可有限重试,会话被吊销则停止并等待新认证,不可重启循环。默认拒绝列表内容和 SDK 是否已开始清除值属版本相关,需实测。安装与计费信息暂未提供。