开发问题排查

场景说明

线上出了问题，排查通常要开三个系统：日志平台搜日志、链路系统查调用、监控看指标，来回切换，自己把散落各处的线索拼成因果链。一条 502 从发现到定位根因，半小时就过去了。

MoAI 把这件事变成一次提问：建一个开发问题排查助手，接上观测平台 ClickStack，用大白话问。AI 自己查日志、追链路、聚合错误分布，直接给出根因、时间线和修复建议，几分钟出一份带证据的排查报告。全程只读查询，不碰线上服务。

可以这样问：

统计最近 15 分钟 ERROR 和 FATAL 日志的时间线（5 分钟粒度），按服务分组，哪个服务错误最多？
列出 moai-ai-gateway 最近 15 分钟的 ERROR 日志 10 条，要包含时间、错误内容、TraceId
取这条日志的 TraceId，把整条调用链的日志都查出来，梳理经过了哪些服务、在哪个环节出错
最近 15 分钟按错误类型聚合一下分布，哪类最多？每类给一条代表性日志
moai-worker 有没有崩溃记录？给出堆栈、发生时间，以及随后是否自动重启
找一条失败的用户登录链路，还原经过的服务和各环节耗时，指出故障点和根因

案例预览

问最近 15 分钟的错误分布，AI 给出 2 张图和一份结论：15 分钟内共 68 条错误，全部集中在 35 秒内爆发，错误最多的是网关服务（17 条）；根因线索直接给出：上游模型通道集体限流加超时，还连带发现 4 条崩溃堆栈和一条疑似暴力破解的登录探测。换以前，这些线索要几个人开三个系统翻半天：

再甩给它一个 TraceId 问这条请求为什么失败，AI 查了 6 次工具，给出链路时序图和排查报告：请求 3.7 秒失败，根因是上游模型渠道限流，重试耗尽后以 502 返回，明确排除本服务代码缺陷；还附带发现同一时段多个渠道集体限流、日志字段映射不一致两个疑点，最后给了 5 条改进建议：

配置过程

第 1 步 · 接入观测平台

插件页选 ClickStack 查询模板，新建实例，填上 ClickStack 对外 API 地址和查询用的 ApiKey。有了这个工具，AI 才能查日志和链路：

第 2 步 · 配置应用并发布

新建一个 Agent 应用，起名开发问题排查；选好模型，插件勾上刚接入的 ClickStack 查询，提示词写明角色（你是开发问题排查助手，通过 ClickStack 分析日志、链路追踪、监控，排查问题），保存发布：

发布后从应用市场进入对话，问一句错误分布，或直接甩一个 TraceId 就能开始排查。