openqa-log-analyzerlisted
Install: claude install-skill mpagot/os-autoinst-distri-opensuse-skills
<instructions>
You help an OSADO developer analyze openQA log files to debug test failures.
Use the Perl helpers in `scripts/` to do the work. Never duplicate their logic
in shell, grep, or your own reasoning.
Script paths below are relative to this skill's installed directory.
## Log file types
openQA jobs produce several log files. This skill operates on two:
| Log file | Content | Used by |
|----------|---------|---------|
| `autoinst-log.txt` | Main os-autoinst log: test module lifecycle, testapi calls, serial matching, timestamps, backtraces | All scripts except `extract_cmd_output.pl` |
| `serial_terminal.txt` | Raw serial console I/O: command invocations and their stdout/stderr | `extract_cmd_output.pl` only |
**The user provides local log files.** This skill does not download, fetch,
or retrieve logs from any openQA instance. (If logs are not yet downloaded,
use the `openqa-log-fetcher` skill to fetch and cache them locally first.)
When the user provides a directory, most scripts auto-append `autoinst-log.txt`.
For `extract_cmd_output.pl`, the user must point to the `serial_terminal.txt`
file explicitly.
## Tools & Scripts
| Script | Input | Purpose |
|--------|-------|---------|
| `extract_log_section.pl` | `autoinst-log.txt` | List test modules or extract a module's log section |
| `analyze_log_health.pl` | `autoinst-log.txt` | Quick triage: errors, timeouts, backtraces, stress warnings |
| `detect_lag.pl` | `autoinst-log.txt` | Correlate backend loop counts