只读排查：列应用、查错误事故与性能

你将得到什么

• 会触发官方只读工具：get_applications、get_exception_incidents、get_incident、get_performance（及可选 get_traces / get_log_lines）
• 完成「先列应用 → 查开放错误 → 看慢动作」的闭环
• 知道多数工具需要 app_name + app_environment；名称大小写不敏感

官方工具一览（本课用到的）

自然语言描述任务即可；Agent 负责选工具填参。需要纠正参数时，直接说出官方参数名（如 states: open、revision: last）。

步骤 1：列出应用

发送：

Use get_applications and list every app_name/app_environment I can access.

对照结果：出现应用列表。记下你要排查的一对，下文用 MyApp / production 作占位——请换成你列表里的真实值。

步骤 2：列出开放错误事故

发送（把应用名换成你的）：

For MyApp production, use get_exception_incidents with states open and show the top incidents: number, exception name, action, last occurrence.

对照结果：一页开放事故（最多约 50 条）。记下一条感兴趣的 incident number（数字 ID）。

可选收窄（官方参数）：

• query：对异常名/动作名做关键词搜索（支持 *）
• revision: "last"：只看最近一次部署引入的错误
• namespaces：如 web,background

步骤 3：打开单条事故详情

发送：

Use get_incident on MyApp production for incident number <NUMBER>. Summarize state, severity, first/last seen, and the top of the stack trace.

对照结果：状态（open / closed / wip）、指派、堆栈摘要。先不要调用 update_incidents 改状态，除非你明确要在客户端批准写权限。

步骤 4：查看性能概览

发送：

For MyApp production, use get_performance and list the slowest actions with mean duration and error rate if available.

对照结果：慢动作或采样性能 traces（Ruby/Elixir 采样；若应用上报 OpenTelemetry，官方还会给出按动作排序的列表）。挑一个慢 action_name（如 BlogPostsController#index）进入可选加深：

Use get_traces for MyApp production in namespace web with action_name BlogPostsController#index, list recent slow traces, then open the slowest trace_id as a span tree.

对照结果：先 list 得到 trace_id，再 tree 模式看到 span 树与按类别的 self time 分解。

步骤 5：（可选）查错误相关日志

若该应用已接入 Logging：

For MyApp production, use get_log_lines with query severity=error and limit 20. Summarize the newest messages.

官方表达式示例：severity=error、message:timeout、severity=error AND hostname=web-1。空 query 表示拉取全部（仍受 limit 限制）。

安全与范围提醒

本课小结

完成以上四步，即达成「Agent 直连 AppSignal 做只读排查」的最小闭环。更多工具（anomaly、check-ins、dashboards、metrics）见官方 Tool Reference。