Merge pull request #273486 from saloniagrawal1997/patch-2

Download dashboard #1 changes

Author: ttorble

articles/load-testing/how-to-export-test-results.md

@@ -12,12 +12,14 @@ ms.topic: how-to
 ---
 # Export test results from Azure Load Testing for use in third-party tools
 
-In this article, you learn how to export your Azure Load Testing test results. You can download the results by using the Azure portal, as an artifact in your CI/CD workflow, in JMeter by using a backend listener, or by copying the results from an Azure storage account. 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.
+In this article, you learn how to export your Azure Load Testing test results and reports. You can download the results by using the Azure portal, as an artifact in your CI/CD workflow, in JMeter by using a backend listener, or by copying the results from an Azure storage account. You can 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 [Diagnose failing load tests](./how-to-diagnose-failing-load-test.md).
 
 You can generate the Apache JMeter dashboard from the CSV log file following the steps mentioned [here](https://jmeter.apache.org/usermanual/generating-dashboard.html#report).
 
+You can also download the Azure Load Testing Result dashboard as an HTML report for offline viewing and collaboration. 
+
 ## Prerequisites  
 
 - An Azure account with an active subscription. If you don't have an Azure subscription, [create a free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.  
@@ -38,16 +40,17 @@ timeStamp,elapsed,label,responseCode,responseMessage,threadName,dataType,success
 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
+## Access and download load test results and report
 
-After a load test run finishes, you can access and download the load test results through the Azure portal, or as an artifact in your CI/CD workflow.
+After a load test run finishes, you can access and download the load test results and the HTML report through the Azure portal, or as an artifact in your CI/CD workflow.
 
 >[!IMPORTANT]
->For load tests with more than 45 engine instances or a greater than 3-hour test run duration, the results file is not available for download. You can [configure a JMeter Backend Listener to export the results](#export-test-results-using-jmeter-backend-listeners) to a data store of your choice or [copy the results from a storage account container](#copy-test-artifacts-from-a-storage-account-container). 
+>For load tests with more than 45 engine instances or a greater than 3-hour test run duration, the results file is not available for download. You can [configure a JMeter Backend Listener to export the results](#export-test-results-using-jmeter-backend-listeners) to a data store of your choice or [copy the results from a storage account container](#copy-test-artifacts-from-a-storage-account-container).
+>For tests with samplers greater than 30, the downloaded HTML report will only have graphs for data aggregated over all samplers. Graphs will not show sampler-wise data. Additionally, the downloaded report will only show graphs corresponding to client-side metrics.
 
 # [Azure portal](#tab/portal)
 
-To download the test results for a test run in the Azure portal:
+To download the test results and the HTML report for a test run in the Azure portal:
 
 1. In the [Azure portal](https://portal.azure.com), go to your Azure Load Testing resource.
 
@@ -67,19 +70,21 @@ To download the test results for a test run in the Azure portal:
      > [!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**.
+   * Select **Download** on the **Test run details** pane. To download the results, select **Results**. To download the HTML report, select **Report**.
 
-     :::image type="content" source="media/how-to-export-test-results/dashboard-download.png" alt-text="Screenshot that shows how to download the test results from the 'Test run details' pane.":::
+     :::image type="content" source="media/how-to-export-test-results/download-dashboard.png" alt-text="Screenshot that shows how to download the test results from the 'Test run details' pane.":::
 
-1. You can use any zip tool to extract the folder and access the test results.
+1. You can use any zip tool to extract the folder and access the downloaded files.
 
     :::image type="content" source="media/how-to-export-test-results/test-results-zip.png" alt-text="Screenshot that shows the test results zip file in the downloads list.":::  
 
-    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.
+    The results folder contains a separate CSV file for every test engine and contains details of requests that the test engine executed during the load test.
+
+   The report folder contains an HTML file that provides a summary of the test run and graphs of the performance metrics for offline viewing and collaboration. 
 
 # [GitHub Actions](#tab/github)
 
-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:
+When you run a load test as part of your CI/CD pipeline, Azure Load Testing generates test results and reports. 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**.
 
@@ -89,7 +94,7 @@ When you run a load test as part of your CI/CD pipeline, Azure Load Testing gene
 
 1. 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.
+    Azure Load Testing places the test results and the HTML report in the `loadTest` folder of the GitHub Actions workspace.
 
     ```yml
     - name: 'Azure Load Testing'
@@ -105,7 +110,7 @@ When you run a load test as part of your CI/CD pipeline, Azure Load Testing gene
         path: ${{ github.workspace }}/loadTest
     ```
 
-1. After your GitHub Actions workflow completes, you can select the test results from the **Artifacts** section on the **Summary** page of the workflow run.
+1. After your GitHub Actions workflow completes, you can select the **loadTestResults** folder from the **Artifacts** section on the **Summary** page of the workflow run.
 
     :::image type="content" source="./media/how-to-export-test-results/github-actions-run-summary.png" alt-text="Screenshot that shows the GitHub Actions workflow summary page, highlighting the test results in the Artifacts section." lightbox="./media/how-to-export-test-results/github-actions-run-summary.png":::
 
@@ -119,7 +124,7 @@ When you run a load test as part of your CI/CD pipeline, Azure Load Testing gene
 
 1. 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.
+    Azure Load Testing places the test results and the HTML report in the `loadTest` folder of the Azure Pipelines default working directory.
 
     ```yml
     - task: AzureLoadTest@1
@@ -134,7 +139,7 @@ When you run a load test as part of your CI/CD pipeline, Azure Load Testing gene
     ```
 1. 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.
+    You can find and download the test results and the report in the **Results** folder.
 
     :::image type="content" source="./media/how-to-export-test-results/azure-pipelines-run-summary.png" alt-text="Screenshot that shows the Azure Pipelines workflow summary page, highlighting the test results in the Stages section." lightbox="./media/how-to-export-test-results/azure-pipelines-run-summary.png":::
 ---