Export test results from Azure Load Testing for use in third-party tools

In this article, you learn how to download the test results from Azure Load Testing in the Azure portal. You might use these results for reporting in third-party tools or for diagnosing test failures. Azure Load Testing generates the test results in comma-separated values (CSV) file format, and provides details of each application request for the load test.

You can also use the test results to diagnose errors during a load test. The responseCode and responseMessage fields give you more information about failed requests. For more information about investigating errors, see Troubleshoot test execution errors.

You can generate the Apache JMeter dashboard from the CSV log file following the steps mentioned here.

Prerequisites

• An Azure account with an active subscription. If you don't have an Azure subscription, create a free account before you begin.
• An Azure Load Testing resource that has a completed test run. If you need to create an Azure Load Testing resource, see Create and run a load test.

Test results file

Azure Load Testing generates a test results CSV file for each test engine instance. Learn how you can scale out your load test.

Azure Load Testing uses the Apache JMeter CSV log format. For more information about the different fields, see the JMeter Glossary in the Apache JMeter documentation.

You can find the details of each application request for the load test run in the test results file. The following snippet shows a sample test result:

timeStamp,elapsed,label,responseCode,responseMessage,threadName,dataType,success,failureMessage,bytes,sentBytes,grpThreads,allThreads,URL,Latency,IdleTime,Connect
1676040230680,104,Homepage,200,OK,172.18.33.7-Thread Group 1-5,text,true,,1607,133,5,5,https://www.example.com/,104,0,100
1676040230681,101,Homepage,200,OK,172.18.33.7-Thread Group 1-3,text,true,,1591,133,5,5,https://www.example.com/,101,0,93
1676040230680,101,Homepage,200,OK,172.18.33.7-Thread Group 1-1,text,true,,1591,133,5,5,https://www.example.com/,98,0,94

Access and download load test results

Azure portal

To download the test results for a test run in the Azure portal:

1. In the Azure portal, go to your Azure Load Testing resource.

2. On the left pane, select Tests to view a list of tests, and then select your test.

   

   Tip

   To limit the number of tests to display in the list, you can use the search box and the Time range filter.

3. You can download the test results file as a zipped folder in either of two ways:

   • Select the ellipsis (...) next to the load test run you're working with, and then select Download results file.

     

     Note

     A load test run needs to have a Done, Stopped, or Failed status for the results file to be available for download.

   • On the Test run details pane, select Download, and then select Results.

     

4. You can use any zip tool to extract the folder and access the test results.

   

   The folder contains a separate CSV file for every test engine and contains details of requests that the test engine executed during the load test.

GitHub Actions

When you run a load test as part of your CI/CD pipeline, Azure Load Testing generates a test results file. Follow these steps to publish these test results and attach them to your CI/CD pipeline run:

1. Go to your GitHub repository, and select Code.

2. In the Code window, select your GitHub Actions workflow YAML file in the .github/workflow folder.

   

3. Edit the workflow file and add the actions/upload-artifact action after the azure/load-testing action in the workflow file.

   Azure Load Testing places the test results in the loadTest folder of the GitHub Actions workspace.

   - name: 'Azure Load Testing'
       uses: azure/load-testing@v1
       with:
         loadTestConfigFile: 'SampleApp.yaml'
         loadTestResource: ${{ env.LOAD_TEST_RESOURCE }}
         resourceGroup: ${{ env.LOAD_TEST_RESOURCE_GROUP }}
   
   - uses: actions/upload-artifact@v2
     with:
       name: loadTestResults
       path: ${{ github.workspace }}/loadTest
   

4. After your GitHub Actions workflow completes, you can select the test results from the Artifacts section on the Summary page of the workflow run.

   

Azure Pipelines

When you run a load test as part of your CI/CD pipeline, Azure Load Testing generates a test results file. Follow these steps to publish these test results and attach them to your CI/CD pipeline run:

1. In your Azure DevOps project, select Pipelines in the left navigation, and select your pipeline from the list.

2. On the pipeline details page, select Edit to edit the workflow definition.

3. Edit the workflow file and add the publish task after the AzureLoadTest task in the workflow file.

   Azure Load Testing places the test results in the loadTest folder of the Azure Pipelines default working directory.

   - task: AzureLoadTest@1
     inputs:
       azureSubscription: $(serviceConnection)
       loadTestConfigFile: 'SampleApp.yaml'
       resourceGroup: $(loadTestResourceGroup)
       loadTestResource: $(loadTestResource)
   
   - publish: $(System.DefaultWorkingDirectory)/loadTest
     artifact: results
   

4. After your Azure Pipelines workflow completes, you can select the test results from the Stages section on the Summary page of the workflow run.

   You can find and download the test results in the Results folder.

   

Next steps

• Learn more about Troubleshooting test execution errors.
• For information about comparing test results, see Compare multiple test results.
• To learn about performance test automation, see Configure automated performance testing.