Add Router troubleshoot playbook and enhance trace analyzer and reporting - #18
Merged
mouxinqq merged 1 commit intoApr 13, 2026
Merged
Conversation
This branch had an error being deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation
trace分析能力以支持更完整的事件链取证(包含原始行、ID 覆盖统计与标签组合分析)。Description
docs/zh/online_serving/router_troubleshoot_playbook.md,提供排查流程、命令模板与现象到日志的快速映射。docs/zh/online_serving/router_faq.md中增加到新排查手册的引用链接。.claude/skills/troubleshoot/SKILL.md,增强 AskUserQuestion 选项的说明并提示trace_id/request_id/session_id的输入方式。scripts/analyzers/trace.py:在事件对象中保留raw行;新增_detect_matched_tags、_format_matched_tag、_build_id_coverage_stats、_build_id_combo_stats等辅助函数;在返回结构中增加matched_tags、id_coverage和id_combos;并在format_trace_report中把 ID 覆盖统计、标签组合明细与每条事件的 RAW 行输出到 detail 报告。scripts/troubleshoot.py中补充时间范围处理变量初始化并改进对--tail与--start/--end的互斥与过滤行为提示。Testing
python3 .claude/skills/troubleshoot/scripts/troubleshoot.py --help以验证 CLI 参数未破坏,执行成功。python3 .claude/skills/troubleshoot/scripts/troubleshoot.py <log_file> --trace <ID> --tail 1000,确认生成的报告包含matched_tag、id_coverage、id_combos与事件RAW行,测试通过。Codex Task