docs: rename readonly analysis to offline investigation

2026-07-02 03:46:30 +00:00
parent dcffef88ae
commit a5fde8cffb
5 changed files with 12 additions and 1 deletions
@@ -20,6 +20,7 @@ bun scripts/cli.ts platform-infra observability search --service <service> --lim
 ## P0 边界

 - 可见性问题优先修复；状态、耗时、失败原因、trace、命令结果或关键证据不可见时，先补 CLI/日志/状态输出。
+- 离线调查中的 OTel 只能分析既有 trace 和已有业务记录；如果 trace/search/diagnose 摘要不好用、缺少业务映射或无法区分 observability gap 与业务失败，先改进 OTel CLI/analyze/instrumentation 可见性，再继续业务结论。
 - OTel 查询默认低噪声摘要；完整 span/context 显式 `--full`/`--raw`。
 - OTel 查询的 `--target` 必须匹配 trace 所属运行面 node/lane；JD01 运行面产生的 trace 用 `--target JD01` 查询，不能拿其他节点查询失败当作 trace 缺失结论。
 - 不把 trace 缺口误判成业务成功；缺少 span 或窗口不完整时，先说明观测边界。