Debugging Integration Tests

In the event of an integration test scenario failing, there are a number of steps to take in order to debug the issue before rerunning the test in question. These steps are outlined below.

Prerequisites

  • You have a snapshot that has completed all build-time tests. These must be completed before attempting to debug the failed test.

  • You have access to the Konflux UI in order to view the logs of the failed test.

Procedure

  1. Identify the IntegrationTestScenario that has failed

    • Open the Konflux and navigate to Application/your_application_name/activity

    • Select "Pipeline Runs" under "Activity By"

    • Your view should look similar to the below image.

    Activity View

  2. Click on the pipeline run that has a status of "Failed". This will take you to a detailed view of the failed run.

  3. Examine the "Log Snippet" section on the right side of this page. It contains the most recent error returned by the integration test. For more comprehensive logs, click on "See Logs". See the below image for reference.

    Test Failed

  4. In this example the output suggests that the pipelineRun is missing an expected parameter, "username". To edit the integration test, follow the procedure provided here.

  5. Rerun the test by following the steps here.

  6. Once the test has been rerun, verify that the test has passed by checking the "Pipeline Runs" tab in the Konflux console. The status of the test should now be "Succeeded". See the below image for reference.

    successfulretest