sentry

Sentry（只读可观测性）

快速开始

• 如果尚未完成身份验证，请让用户运行 sentry auth login，或将 SENTRY_AUTH_TOKEN 设置为环境变量。
• CLI 会从 .env 文件、源代码、配置默认值和目录名称中的 DSN 自动检测组织和项目。只有在自动检测失败或选错目标时，才指定 <org>/<project>。
• 默认值：时间范围 24h、环境 production、数量上限 20。
• 以编程方式处理输出时，始终使用 --json。使用 --json --fields 选择特定字段并减少输出大小。
• 使用 sentry schema <resource> 快速发现 API 端点。

如果未安装 CLI，请向用户提供以下步骤：

1. 安装 Sentry CLI：curl https://cli.sentry.dev/install -fsS | bash
2. 完成身份验证：sentry auth login
3. 确认身份验证状态：sentry auth status

• 切勿让用户在聊天中粘贴完整令牌。请让他们在本地设置令牌，并在准备就绪后确认。

核心任务（使用 Sentry CLI）

所有查询都使用 sentry CLI。它会自动处理身份验证、组织和项目检测、分页及重试。使用 --json 获取机器可读的输出。

1) 列出问题（按最近发生时间排序）

sentry issue list \
  --query "is:unresolved environment:production" \
  --period 24h \
  --limit 20 \
  --json --fields shortId,title,priority,level,status

如果自动检测无法确定组织或项目，请显式传入：

sentry issue list {your-org}/{your-project} \
  --query "is:unresolved environment:production" \
  --period 24h \
  --limit 20 \
  --json

2) 将问题短 ID 解析为问题详情

sentry issue view {ABC-123} --json

使用短 ID 格式（例如 ABC-123），不要使用数字 ID。

3) 问题详情

sentry issue view {ABC-123}

4) 问题事件

sentry issue events {ABC-123} --limit 20 --json

5) 事件详情

sentry event view {your-org}/{your-project}/{event_id} --json

6) AI 驱动的根因分析

sentry issue explain {ABC-123}

7) AI 驱动的修复计划

sentry issue plan {ABC-123}

回退方案：任意 API 访问

对于专用 CLI 命令未涵盖的端点，请使用 sentry api：

sentry api /api/0/organizations/{your-org}/ --method GET

使用 sentry schema 发现可用的 API 端点：

sentry schema issues

输入和默认值

• org_slug、project_slug：CLI 会从 DSN、环境变量和目录名称中自动检测。如果自动检测失败，请使用位置参数 {your-org}/{your-project} 覆盖。
• time_range：默认值为 24h（传入 --period 24h）。
• environment：默认值为 prod（作为 --query 的一部分传入，例如 environment:production）。
• limit：默认值为 20（通过 --limit 传入）。
• search_query：可选的 --query 参数，使用 Sentry 搜索语法（例如 is:unresolved、assigned:me）。
• issue_short_id：直接与 sentry issue view 搭配使用。

输出格式规则

• 问题列表：显示标题、short_id、状态、first_seen、last_seen、count、environments、top_tags；按最近发生时间排序。
• 事件详情：包含 culprit、timestamp、environment、release、url。
• 如果没有结果，请明确说明。
• 对输出中的 PII 进行脱敏（电子邮件、IP）。不要打印原始堆栈跟踪。
• 切勿回显身份验证令牌。

黄金测试输入

• 组织：{your-org}
• 项目：{your-project}
• 问题短 ID：{ABC-123}

示例提示词：“列出过去 24h 内生产环境中最常见的 10 个未解决问题。” 预期结果：按顺序排列的列表，包含标题、短 ID、数量和最近发生时间。