名称: sentry监控 描述: Sentry错误跟踪和性能监控，用于实时查看应用程序错误、性能问题和发布健康 版本: 1.0.0 模型: sonnet 调用方式: 两者 用户可调用: true 工具: [Bash, Read, WebFetch] 最佳实践:
- 切勿在输出中暴露认证令牌
- 对于破坏性操作需要确认
- 使用环境变量存储凭据 错误处理: 优雅 流式传输: 支持 已验证: false 最后验证时间: 2026-02-19T05:29:09.098Z
模式: 认知/提示驱动 — 无独立实用脚本；通过代理上下文使用。
Sentry监控技能
概述
与原始Sentry API调用相比，提供90%以上的上下文节省。按功能类别渐进披露：错误跟踪、性能监控、发布管理和项目配置。
要求
- Sentry账户，已配置项目
SENTRY_AUTH_TOKEN环境变量（可选，用于认证API调用）SENTRY_ORG环境变量（可选，默认为第一个组织）SENTRY_PROJECT环境变量（可选，默认为第一个项目）
工具（渐进披露）
错误跟踪
| 工具 | 描述 | 确认 |
|---|---|---|
| list-issues | 列出近期问题/错误 | 否 |
| issue-details | 获取详细问题信息 | 否 |
| resolve-issue | 标记问题为已解决 | 是 |
| ignore-issue | 忽略/暂缓问题 | 是 |
性能监控
| 工具 | 描述 | 确认 |
|---|---|---|
| list-transactions | 列出性能事务 | 否 |
| transaction-summary | 获取事务性能统计 | 否 |
| slow-queries | 识别慢数据库查询 | 否 |
发布管理
| 工具 | 描述 | 确认 |
|---|---|---|
| list-releases | 列出发布 | 否 |
| create-release | 创建新发布 | 是 |
| set-commits | 将提交关联到发布 | 是 |
项目配置
| 工具 | 描述 | 确认 |
|---|---|---|
| list-projects | 列出Sentry项目 | 否 |
| project-settings | 查看项目设置 | 否 |
| list-alerts | 列出警报规则 | 否 |
快速参考
# 列出近期问题
curl -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" \
"https://sentry.io/api/0/projects/$SENTRY_ORG/$SENTRY_PROJECT/issues/?query=is:unresolved"
# 获取问题详情
curl -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" \
"https://sentry.io/api/0/issues/{issue_id}/"
# 解决问题
curl -X PUT -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" \
"https://sentry.io/api/0/issues/{issue_id}/" \
-d '{"status": "resolved"}'
# 列出事务
curl -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" \
"https://sentry.io/api/0/organizations/$SENTRY_ORG/events/?field=transaction"
# 创建发布
curl -X POST -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" \
"https://sentry.io/api/0/organizations/$SENTRY_ORG/releases/" \
-d '{"version": "1.0.0", "projects": ["project-slug"]}'
# 列出项目
curl -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" \
"https://sentry.io/api/0/organizations/$SENTRY_ORG/projects/"
配置
环境变量
| 变量 | 必需 | 描述 |
|---|---|---|
SENTRY_AUTH_TOKEN |
可选 | Sentry认证令牌用于API调用 |
SENTRY_ORG |
可选 | 组织slug（默认为第一个组织） |
SENTRY_PROJECT |
可选 | 项目slug（默认为第一个项目） |
SENTRY_DSN |
否 | 用于SDK集成（本技能未使用） |
获取认证令牌
- 导航到Sentry设置 → 账户 → API → 认证令牌
- 创建新令牌，权限：
project:read,project:write,event:read - 设置为环境变量：
export SENTRY_AUTH_TOKEN=your_token_here
安全
⚠️ 切勿在输出中暴露认证令牌 ⚠️ 破坏性操作（resolve-issue, ignore-issue, create-release, set-commits）需要确认 ⚠️ 使用环境变量存储凭据，切勿硬编码
代理集成
- devops（主要）：生产监控、事件响应
- incident-responder（主要）：错误分类、问题解决
- developer（次要）：调试、性能优化
- qa（次要）：测试环境监控
错误处理
如果工具执行失败：
- 验证
SENTRY_AUTH_TOKEN已设置：echo $SENTRY_AUTH_TOKEN - 检查令牌权限包括所需范围
- 验证组织和项目slug正确
- 检查Sentry API速率限制（默认：3000请求/分钟）
常见工作流
事件响应
list-issues- 获取近期未解决问题issue-details- 调查特定问题resolve-issue- 部署修复后标记为已解决
性能优化
list-transactions- 识别慢端点transaction-summary- 分析性能模式slow-queries- 查找数据库瓶颈
发布管理
create-release- 创建新发布版本set-commits- 关联提交到发布list-releases- 跟踪发布健康
故障排除
| 问题 | 解决方案 |
|---|---|
| 401 未授权 | 检查SENTRY_AUTH_TOKEN是否有效且未过期 |
| 403 禁止访问 | 验证令牌有必需权限（project:read, project:write, event:read） |
| 404 未找到 | 验证SENTRY_ORG和SENTRY_PROJECT是正确slug |
| 速率限制超出 | 等待1分钟，减少请求频率 |
相关
- Sentry API文档：https://docs.sentry.io/api/
- Sentry错误跟踪：https://docs.sentry.io/product/issues/
- Sentry性能：https://docs.sentry.io/product/performance/
- Sentry发布：https://docs.sentry.io/product/releases/
内存协议（强制）
开始前：
读取.claude/context/memory/learnings.md
完成后：
- 新模式 ->
.claude/context/memory/learnings.md - 发现的问题 ->
.claude/context/memory/issues.md - 做出的决策 ->
.claude/context/memory/decisions.md
假设中断：如果不在内存中，则未发生。