Sentry错误监控工具

技能简介

sentry-cli 是 Sentry.io 官方提供的命令行工具，用于在终端完成错误监控、版本发布、源码映射上传和调试文件管理等操作。

业务背景

开发团队通过命令行工具直接管理错误监控全流程，无需切换Web界面即可完成版本发布标记、源码映射上传等关键操作。在CI/CD流水线中嵌入自动化命令，实现构建即部署、部署即监控的闭环，显著缩短问题发现与修复周期，保障线上服务稳定性。

落地案例：前端团队完成React应用构建后，执行sentry-cli releases new v2.1.0创建版本，随即上传source maps文件至Sentry平台。当生产环境报错时，平台自动还原压缩后的堆栈信息，定位到具体组件和代码行。运维人员同步在流水线中添加定时任务监控配置，对关键批处理作业进行心跳检测。

能做什么

• 创建并管理应用版本发布（Releases）
• 上传 JavaScript 源码映射（Source Maps）用于错误还原
• 上传 iOS dSYM 和 Android ProGuard 调试文件
• 发送测试事件、查询和处理问题（Issues）
• 配置定时任务监控（Cron Monitors）
• 集成 CI/CD 流水线实现自动化部署追踪

使用说明

安装步骤

# macOS
brew install sentry-cli

# npm 跨平台安装
npm install -g @sentry/cli

# 直接下载
curl -sL https://sentry.io/get-cli/ | bash

认证配置

# 交互式登录（打开浏览器）
sentry-cli login

# 或直接设置令牌
export SENTRY_AUTH_TOKEN="sntrys_..."

# 验证配置
sentry-cli info

也可将令牌写入 ~/.sentryclirc 配置文件。

基础用法示例

# 创建并完结版本
sentry-cli releases new "$VERSION" --finalize

# 上传源码映射
sentry-cli sourcemaps upload ./dist --release="$VERSION"

# 标记部署环境
sentry-cli releases deploys "$VERSION" new -e production

# 发送测试事件
sentry-cli send-event -m "Test error message"

输入与输出

见下方输入与输出表格。

风险提示

• 认证令牌需妥善保管，避免硬编码在代码仓库中
• 源码映射包含原始代码信息，上传前确认权限范围
• 版本号建议与 Git 提交哈希或语义化版本保持一致
• 调试文件体积较大时，注意上传超时和网络稳定性

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/iahmadzain/sentry-cli/SKILL.md
来源类型：GitHub 技能仓库