Merge pull request #185113 from ntrogh/alt-worker-log

Updated article for changes to JMeter worker logs

Author: LJSpiller

articles/load-testing/how-to-find-download-logs.md

@@ -1,28 +1,30 @@
 ---
-title: Download Apache JMeter logs for troubleshooting 
+title: Troubleshoot load test errors
 titleSuffix: Azure Load Testing
-description: Learn how you can troubleshoot Apache JMeter script problems by downloading the Azure Load Testing logs in the Azure portal.
+description: Learn how you can troubleshoot errors during your load test by downloading and analyzing the Apache JMeter logs in the Azure portal.
 services: load-testing
 ms.service: load-testing
 ms.author: nicktrog
 author: ntrogh
-ms.date: 11/30/2021
+ms.date: 01/14/2022
 ms.topic: how-to
 
 ---
-# Troubleshoot JMeter problems by downloading Azure Load Testing Preview logs
+# Troubleshoot load test errors by downloading Apache JMeter logs in Azure Load Testing Preview
 
-In this article, you'll learn how to download the Azure Load Testing Preview logs in the Azure portal to troubleshoot problems with the Apache JMeter script.
+In this article, you'll learn how to download the Apache JMeter logs for Azure Load Testing Preview in the Azure portal. You can use the logging information to troubleshoot problems while the Apache JMeter script runs.
 
-When you run a load test, the Azure Load Testing test engines execute your Apache JMeter test script. The Apache JMeter log can help you identify both problems in the JMX file and issues that occur during the test execution. For example, the application endpoint might be unavailable, or the JMX file might contain invalid credentials.
+The Apache JMeter log can help you identify problems in your JMX file, or run-time issues that occur while the test is running. For example, the application endpoint might be unavailable, or the JMX file might contain invalid credentials.
+
+When you run a load test, the Azure Load Testing test engines execute your Apache JMeter test script. While your load test is running, Apache JMeter stores detailed logging information in the worker node logs. You can download the JMeter worker node log for your load test run from the Azure portal to help you diagnose load test errors.
 
 > [!IMPORTANT]
 > Azure Load Testing is currently in preview. For legal terms that apply to Azure features that are in beta, in preview, or otherwise not yet released into general availability, see the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
 
 ## 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.  
-- 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](./quickstart-create-and-run-load-test.md).  
+- 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](./quickstart-create-and-run-load-test.md).  
 
 ## Access and download logs for your load test  
 
@@ -43,16 +45,20 @@ In this section, you retrieve and download the Azure Load Testing logs from the
 
 1. On the dashboard, select **Download**, and then select **Logs**.  
 
-    :::image type="content" source="media/how-to-find-download-logs/logs.png" alt-text="Screenshot that shows how to download the load test logs from the test result page.":::  
+    :::image type="content" source="media/how-to-find-download-logs/logs.png" alt-text="Screenshot that shows how to download the load test logs from the test run details page.":::  
 
-    The browser should now start downloading the execution logs as a zipped folder.
+    The browser should now start downloading the JMeter worker node log file *worker.log*.
 
-1. You can use any extraction tool to extract the zipped folder and access the logging information.
+1. You can use a text editor to open the log file.
 
     :::image type="content" source="media/how-to-find-download-logs/jmeter-log.png" alt-text="Screenshot that shows the JMeter log file content.":::  
 
+    The *worker.log* file can help you diagnose the root cause of a failing load test. In the previous screenshot, you can see that the test failed because a file is missing.
+
 ## Next steps
 
-- For more information about comparing test results, see [Compare multiple test results](./how-to-compare-multiple-test-runs.md).
+- Learn how to [Monitor server-side application metrics](./how-to-update-rerun-test.md).
+
+- Learn how to [Get detailed insights for Azure App Service based applications](./how-to-appservice-insights.md).
 
-- To learn about performance test automation, see [Configure automated performance testing](./tutorial-cicd-azure-pipelines.md).
+- Learn how to [Compare multiple load test runs](./how-to-compare-multiple-test-runs.md).