Skip to content

Enhance troubleshoot tools: select/release matching, cache cross-diagnosis, detailed reports and diagnostics - #16

Merged
mouxinqq merged 2 commits into
developfrom
codex/modify-troubleshoot-for-skills-alignment-z2tpws
Apr 13, 2026
Merged

mouxinqq merged 2 commits into
developfrom
codex/modify-troubleshoot-for-skills-alignment-z2tpws

Conversation

@mouxinqq

Copy link
Copy Markdown
Owner

Motivation

  • Improve log-based troubleshooting by enriching select/release matching, inferring worker types for ambiguous releases, and surfacing more actionable diagnostics and detail files.
  • Add cross-dimension cache diagnostics and clearer explanations/metrics to make reports easier to interpret.

Description

  • Augment match_select_release and log_parser with worker URL normalization, FIFO-based matching, ID-consistency checks, inference of release/token types, and worker-type profiling; return additional fields such as id_consistency, unmatched_releases, worker_type_profile, and id_mismatched_matches.
  • Add counter last-state analysis in analyzers/load.py (_analyze_counter_last_state) and include it in load report outputs and detail file detail/load_counter_state.md.
  • Enhance cache analyzer (analyzers/cache.py) with _analyze_cross_diagnosis and produce both summary and a separate detail section for cache diagnosis; update format_cache_report to output summary + detail payload.
  • Improve error analyzer (analyzers/errors.py) with IMPACT_RULES, classify_impact, and URL extraction for top-N error details; surface YAML-missing hint for Failed to read YAML file config/register.yaml.
  • Health analyzer (analyzers/health.py) now includes register events into event streams and computes detection latency (avg_detect_latency_s) to report detection timing in tables.
  • Latency and other formatters: add metric/capability notes and move detailed diagnoses into separate detail files (e.g. detail/latency_diagnoses.md).
  • Fix table separator logic in scripts/chart.py::render_table to generate proper markdown table separators for right/left alignment.
  • scripts/troubleshoot.py improvements: smarter determine_log_file searching (supports fuzzy names and quoted paths), richer format_full_report producing many detail files, and saving those details in save_detailed_report.
  • Add small helpers and tests in log_parser.py for URL/key normalization and token-release type inference; include self-test cases exercising match_select_release behaviors.

Testing

  • Ran scripts/log_parser.py self-test which includes new match_select_release sample cases, and the added checks for token-release type inference and ID consistency passed.
  • Executed scripts/troubleshoot.py end-to-end on sample logs to verify report generation and that detail files such as detail/load_select_release.md, detail/cache_diagnosis.md, and detail/errors_topn.md are produced (smoke tests succeeded).

Codex Task

@mouxinqq
mouxinqq merged commit ad1ee5d into develop Apr 13, 2026
1 of 2 checks passed

This branch had an error being deployed

1 failed deployment
Metax_ci d234a5f8 Deployed Apr 13, 2026 by mouxinqq via Trigger Jenkins for PR #24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant