日志排查技巧

日志排查技巧

这些技巧能让一个难缠的 bug 变得可处理，把嘈杂的日志流变成你能交给 Agent 的干净证据。

保存过滤规则

就地过滤是当下用的，规则是给项目留的。当一组过滤组合反复有用时，把它存下来。

• 保存为规则 / 从当前过滤保存：把当前生效的过滤变成一条命名、可复用的规则。
• 一条规则有名称、关键词、类型（包含 / 排除）、逻辑（AND / OR）。
• 规则跟随项目。点一条规则可启用 / 禁用；管理过滤规则编辑整组。

攒一个小规则库 —— 比如一条”屏蔽噪声”的排除规则、一条”只看错误”的包含规则 —— 每次排查按需切换，不用重打关键词。

证据打钉

钉子是你把原始日志变成给 Agent（或同事）的报告的方式，是证据的基本单位。

• 给某行日志打钉；加一条备注（“补充给 Agent 的说明”）说明它为什么重要。
• 时间同步把其他分栏对齐到某个钉子的时间戳，让分栏在同一时刻对齐。
• 复制并带 cursor、复制 Markdown 或导出 .md，把钉子、备注和上下文带出去。

证据抽屉把钉子按四种方式组织，范围可选当前 / 选择 / 全部：

• 时间线 —— 跨面板（轨道）的所有钉子，按时间排列。
• 已钉日志 —— 已钉行及其备注的平铺列表。
• 区间 —— 同一面板里相邻的两个钉子会自动形成一个区间，即两钉之间一段有边界的日志窗口。这就是圈复现窗口的方式：在开头打一钉、在结尾打一钉，中间这一段就归你 —— 可按区间保留或跳过，再导出。不再有独立的”开始 / 停止录制”，两个钉子就圈出了窗口。
• 预览 —— 你正要复制或导出的那份 Markdown。

收益：不用再往 Agent 那粘一大堵日志墙，你粘的是一份紧凑的 Markdown —— 带备注、带对齐时间戳的已钉行。这才是 Agent 能据以推理的证据 —— 见工具给证据，AI 下根因。

跨服务 Trace 搜索

一个请求会穿过很多服务。一个搜索标签把它们重新串回来：用 traceID 搜、打开 trace 上下文、复制跨服务路径。这是一套独立的工作流 —— 见跨服务搜索。

交给 Agent

这里每个技巧的结尾都一样：你产出一份有边界、带标注的东西 —— 一条规则的输出、一段钉子区间、一束钉子、一份 trace 上下文 —— 然后交给 Agent。Agent 据证据推理，而不是靠猜。把闭环收紧：自行定位到自行修复。