SuperAPI AI 工具集

sentry-deploy-integration

部署与运维

查看项目

更新于 10-15 23:29

技能介绍

用途:把 Sentry 接入部署流程,让每次发布可端到端跟踪——提交关联、Source Map 上传、部署记录与部署后健康监控,并将错误关联到具体部署与引入问题的提交。

前提:安装 Sentry CLI(npm i -g @sentry/cli 或 curl -sL https://sentry.io/get-cli/ | bash);SENTRY_AUTH_TOKEN 具备 project:releases 和 org:read 权限;设置 SENTRY_ORG 与 SENTRY_PROJECT;应用安装 @sentry/node v8+;在 Sentry 中启用源码控制集成。

主要能力:用 sentry-cli releases new/set-commits --auto/sourcemaps upload/finalize 创建发布、关联提交并上传 Source Map;用 releases deploys new -e 环境 -t 开始 -f 结束 记录部署,支持 staging→production 多环境晋级;在 SDK 中设置 release 与 environment 以启用会话跟踪,Sentry 自动统计崩溃零会话率、崩溃零用户率、采用率、错误数与会话数;通过 Releases API 比较发布、查看新问题与健康数据;配置部署通知 webhook 触发冒烟测试或通知;回滚时记录指向上一稳定版本的新部署。

使用方式:在部署脚本中按顺序创建发布、关联提交、上传 Source Map、finalize,部署应用后记录部署时间戳;在 Sentry.init() 中传入 release 和 environment;在 GitHub Actions 等 CI 中执行相同 CLI 步骤(fetch-depth: 0 以便 set-commits)。

限制与常见问题:令牌权限不足会 401;发布不存在时先运行 releases new;健康数据需 SDK v8+ 且未禁用会话跟踪;environment 未设置会导致事件环境错误;可疑提交需已链接 GitHub/GitLab;CLI 与 SDK 的 release 版本必须完全一致,否则崩溃率异常;缺少 -t/-f 会使时间戳为零。具体平台与价格等资料暂未提供。