Native Sentry

🐛 生产错误追踪与根因分析

通过 Sentry REST API 读取生产错误与事件,支持查询未解决 issue、获取堆栈跟踪及汇总系统健康状态,需只读权限 Token。

收藏
2.9k
安装
1.3k
版本
0.1.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Sentry skill 提供对 Sentry 错误监控平台的只读访问能力,帮助开发者快速排查生产环境问题。主要功能包括:

  • Issue 列表查询:按时间范围(24h/7d/30d)、环境(prod/staging)、状态(is:unresolved)筛选未解决问题
  • Issue 详情获取:查看特定错误的完整元数据、首次/最后出现时间、影响用户数
  • 事件溯源:获取某 issue 关联的原始事件流,支持查看堆栈跟踪(需加 --include-entries)
  • 短 ID 解析:将如 ABC-123 的友好 ID 转为内部 issue ID

技术实现上,该 skill 通过 Python 脚本封装 Sentry REST API,支持 SaaS 及自托管实例(通过 --base-url 配置)。默认启用 PII 脱敏(邮箱、IP 等),可通过 --no-redact 关闭。

显著优点

1. 生产故障快速定位:无需登录 Web 界面,命令行即可获取错误上下文
2. 安全默认值:PII 自动脱敏、堆栈跟踪默认隐藏,降低敏感信息泄露风险

3. 灵活查询:支持 Sentry 原生搜索语法(如 is:unresolved error.level:error)

4. 环境变量驱动:支持 SENTRY_ORG/SENTRY_PROJECT 预配置,减少重复参数

潜在局限

  • 只读限制:无法通过 API 标记 resolved 或分配负责人,仍需人工介入 Web 端
  • 速率限制:Sentry API 对高频查询有配额限制,大规模日志分析场景下效率受限
  • 堆栈跟踪性能:大型事件包含完整堆栈时,解析耗时显著增加
  • Token 权限边界:需确保 Token 仅含 project:read/event:read/org:read,避免误配写权限

适合人群

  • 运维工程师:生产告警后快速确认错误影响面
  • 全栈开发者:排查客户端/服务端异常,无需切换上下文
  • SRE 团队:构建自动化故障摘要报告

常规风险

  • Token 泄露:SENTRY_AUTH_TOKEN 需妥善保管,建议通过密钥管理注入而非硬编码
  • PII 残留:脱敏规则可能不完整,--no-redact 开启时需确保输出环境安全
  • 自托管实例证书:企业内部 Sentry 若使用自签证书,需额外配置 SSL 信任链
  • 查询范围过大:未加 --limit 或 --time-range 约束时,可能拉取过量数据导致超时

Native Sentry 内容

scripts文件夹
手动下载zip · 3.9 kB
sentry_api.pytext/plain
请选择文件