CI E2e Debug
Testing & Qualityci-e2e-debugCI E2e Debug is an Agent Skill for testing & quality published in the apache/skywalking repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Download and inspect CI e2e test logs from GitHub Actions artifacts. Use when investigating e2e test failures in CI.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/apache/skywalking/blob/HEAD/.claude/skills/ci-e2e-debug/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/ci-e2e-debug, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
CI E2E Debug Skill
Download test log artifacts from a GitHub Actions CI run and inspect them for errors.
Steps
-
Find the artifact: Use
gh apito list artifacts for the given CI run:gh api repos/apache/skywalking/actions/runs/<RUN_ID>/artifacts --jq '.artifacts[] | {id: .id, name: .name}' -
Download and extract: Download the artifact zip and extract it:
cd /tmp && rm -rf e2e-debug-logs && mkdir e2e-debug-logs && cd e2e-debug-logs gh api repos/apache/skywalking/actions/artifacts/<ARTIFACT_ID>/zip > artifact.zip unzip -o artifact.zip -
Inspect OAP logs: Look for errors in the OAP server logs:
# Find OAP log files find /tmp/e2e-debug-logs -name "skywalking-oap-*.log" -o -name "oap.log" # Check for errors grep -E "ERROR|Exception|FATAL|CannotCompileException" <log_file> | head -30 -
Inspect other component logs: Check BanyanDB, UI, and other pod logs as needed.
-
Report findings: Summarize the root cause error from the logs.
Notes
- CI artifacts are automatically uploaded by the e2e test framework to
$SW_INFRA_E2E_LOG_DIR - Log files are organized by namespace/pod name
- OAP init pods may have different errors than the main OAP pod — check all of them
- Common errors: MAL/LAL/OAL compilation failures, storage connection issues, module initialization errors
- Profile exporter tests (e.g., Trace Profiling ES): the exporter runs as a separate process with
MockCoreModuleProvider. If a new service is added toCoreModule.services()but not registered in the mock, the exporter fails at startup withrequiredCheck()error — but the OAP logs will show no errors (OAP is fine, the exporter subprocess is what fails). Check the test step that runsprofile_exporter.sh. - When OAP logs are clean but tests fail: look at which specific test step failed. Some e2e tests invoke standalone tools (profile exporter, data generator) that boot with mock providers and may fail independently of OAP.