SuperAPI AI 工具集

investigate-errors

部署与运维

查看项目

更新于 10-16 06:56

技能介绍

用途

investigate-errors(完整名称 sentry:investigate-errors)用于调查 Sentry 项目中近期出现的错误与异常,帮助识别问题、模式与根本原因,快速对 Sentry 捕获的错误进行分诊与排查。

主要能力

该命令会:

  • 询问 Sentry 项目名称(或列出可用项目)
  • 请求时间范围(例如 last 24h、last 7d 或自定义)
  • 使用 Sentry MCP 工具获取近期错误问题
  • 分析错误模式与趋势
  • 提供以下方面的洞察:
    • 最频繁的错误
    • 近期错误激增
    • 受影响的用户/会话
    • 按发布版本/环境划分的错误分布
    • 堆栈跟踪与上下文
  • 给出后续调查步骤建议

使用方式

命令形式:

/investigate-errors [arguments]

用法:

/investigate-errors [project-name] [timeframe]

参数:

  • project-name(可选):Sentry 项目 slug
  • timeframe(可选):时间范围(1h、24h、7d、30d 或自定义)

前置条件

  • 必须安装并配置 Sentry MCP 服务器
  • 必须完成与 Sentry 的 OAuth 认证
  • 需要拥有目标 Sentry 项目的访问权限

示例交互

用户:/investigate-errors my-web-app 24h

Claude:正在调查 my-web-app 过去 24 小时的错误……

错误调查报告

概览

  • 总问题数:12 个错误问题
  • 总事件数:347 个错误事件
  • 受影响用户:89 个唯一用户
  • 时间范围:过去 24 小时

主要问题

  1. TypeError: Cannot read property 'id' of undefined

    • 事件数:156
    • 用户数:45
    • 首次出现:23 小时前
    • 最近出现:12 分钟前
    • 环境:production
    • 发布版本:v2.3.1
    • 趋势:上升(过去 6 小时出现激增)
  2. NetworkError: Failed to fetch user data

    • 事件数:89
    • 用户数:23
    • 首次出现:18 小时前
    • 最近出现:1 小时前
    • 环境:production
    • 发布版本:v2.3.1
  3. ReferenceError: localStorage is not defined

    • 事件数:67
    • 用户数:34
    • 首次出现:22 小时前
    • 最近出现:3 小时前
    • 环境:production、staging

关键模式

  • 45% 的错误与 23 小时前的 v2.3.1 部署相关
  • TypeError 激增始于部署后 6 小时
  • NetworkError 似乎是间歇性的(API 不稳定?)
  • localStorage 错误仅限于服务端渲染上下文

建议

  1. 立即:调查 v2.3.1 中的 TypeError——可能是用户数据处理方面的回归
  2. 高优先级:检查 API 稳定性以解决 fetch 失败
  3. 中优先级:为 localStorage 访问添加服务端渲染防护

是否希望我深入调查某个具体错误?

提示

  • 从较短的时间范围开始,以便更快完成调查
  • 寻找与部署相关的错误激增
  • 使用错误分组来识别模式
  • 检查发布版本和环境标签以寻找关联
  • 查看堆栈跟踪以发现常见代码路径
  • 使用 Seer AI 进行自动化根本原因分析

相关命令

  • /analyze-performance:调查性能问题
  • /check-releases:查看近期发布健康状况
  • /query-events:运行自定义 Sentry 查询

限制

资料未提供该命令的收费、价格、平台支持范围或效果保证等信息。