feat: 支持按错误文案搜索 OTel trace

2026-06-20 02:00:52 +00:00
parent 4928cfc9b8
commit e64c01e458
3 changed files with 416 additions and 2 deletions
@@ -42,6 +42,19 @@ bun scripts/cli.ts platform-infra observability trace \

 默认输出不得展开完整 Tempo JSON；需要原始响应时才用 `--raw`。

+当只有错误文案而没有 OTel trace id 时，先用 `search` 从 Tempo 最近 trace 中反查候选，再进入 `trace`：
+
+```bash
+bun scripts/cli.ts platform-infra observability search \
+  --target D601 \
+  --grep 'no rollout found' \
+  --lookback-minutes 360 \
+  --candidate-limit 80 \
+  --limit 20
+```
+
+`search` 会通过受控 service proxy 调 Tempo `/api/search` 取候选 trace，并逐条拉 trace 做本地 grep 摘要；默认只输出匹配 trace、服务、业务 traceId、错误 span 和下一步命令。扩大时间窗或候选数必须显式传 `--lookback-minutes` / `--candidate-limit`，避免大 trace 输出淹没上下文。
+
 ## 噪声压制

 按错误文案、span 名、failureKind 或关键属性定位时，优先用 `--grep`：