Skip to content

Commit

Permalink
doc: add hints for test failures debugging
Browse files Browse the repository at this point in the history
  • Loading branch information
rvykydal committed Feb 22, 2024
1 parent 57faa86 commit 00fe72d
Showing 1 changed file with 8 additions and 0 deletions.
8 changes: 8 additions & 0 deletions containers/runner/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -151,3 +151,11 @@ container after the run. To do that:
1. Run `containers/runner/launch` with `-c` argument in addition to other arguments. This will
open shell of the container where you can do what you want to before starting the test.
2. Start the test(s) execution with `/kickstart-tests/containers/runner/run-kstest`.

## Debugging test failures

If you want to keep virtual machine of a finished test alive for further investigation add a `halt` command to the end of the test.

If you want to prevent killing virtual machine of a test on a failure detected in the log before the installation finishes (eg `Traceback` indicated in the log) it is possible to configure monitored messages in the [log monitor](/scripts/launcher/lib/log_monitor/log_handler.py) file.

We are tracking the test issues and flakes in the repository issues. There is a [script](/scripts/classify-failures) to detect such known issues from test logs.

0 comments on commit 00fe72d

Please sign in to comment.