Merge pull request #215203 from ntrogh/alt-freshness

[Azure Load Testing] Freshness pass

Author: v-ccolin

articles/load-testing/concept-load-testing-concepts.md

@@ -45,7 +45,7 @@ The configuration of a load test consists of:
 - [Environment variables](./how-to-parameterize-load-tests.md).
 - [Secret parameters](./how-to-parameterize-load-tests.md).
 - The number of [test engines](#test-engine) to run the test script on.
-- The [pass/fail criteria](./how-to-define-test-criteria.md) for the test.
+- The [fail criteria](./how-to-define-test-criteria.md) for the test.
 - The list of [app components and resource metrics to monitor](./how-to-monitor-server-side-metrics.md) during the test execution.
 
 When you run a test, a [test run](#test-run) instance is created.
@@ -76,7 +76,7 @@ When you create or update a load test, you can configure the list of app compone
 
 During a load test, Azure Load Testing collects metrics about the test execution. There are two types of metrics:
 
-- *Client-side metrics* give you details reported by the test engine. These metrics include the number of virtual users, the request response time, the number of failed requests, or the number of requests per second. You can [define pass/fail criteria](./how-to-define-test-criteria.md) based on client-side metrics to specify when a test passes or fails.
+- *Client-side metrics* give you telemetry reported by the test engine. These metrics include the number of virtual users, the request response time, the number of failed requests, or the number of requests per second. You can [define test fail criteria](./how-to-define-test-criteria.md) based on these client-side metrics.
 
 - *Server-side metrics* are available for Azure-hosted applications and provide information about your Azure [application components](#app-component). Azure Load Testing integrates with Azure Monitor, including Application Insights and Container insights, to capture details from the Azure services. Depending on the type of service, different metrics are available. For example, metrics can be for the number of database reads, the type of HTTP responses, or container resource consumption.
 

articles/load-testing/how-to-appservice-insights.md

@@ -1,23 +1,21 @@
 ---
-title: Get more insights from App Service diagnostics
+title: Get load test insights from App Service diagnostics
 titleSuffix: Azure Load Testing
-description: 'Learn how to get detailed insights from App Service diagnostics and Azure Load Testing for App Service workloads.'
+description: 'Learn how to get detailed application performance insights from App Service diagnostics and Azure Load Testing.'
 services: load-testing
 ms.service: load-testing
 ms.author: nicktrog
 author: ntrogh
-ms.date: 11/30/2021
+ms.date: 10/24/2022
 ms.topic: how-to
 
 ---
 
-# Get detailed insights from App Service diagnostics and Azure Load Testing Preview for Azure App Service workloads
+# Get performance insights from App Service diagnostics and Azure Load Testing Preview
 
-In this article, you'll learn how to gain more insights from Azure App Service workloads by using Azure Load Testing Preview and Azure App Service diagnostics.
+Azure Load Testing Preview collects detailed resource metrics across your Azure app components to help identify performance bottlenecks. In this article, you learn how to use App Service Diagnostics to get additional insights when load testing Azure App Service workloads.
 
-[App Service diagnostics](../app-service/overview-diagnostics.md) is an intelligent and interactive way to help troubleshoot your app, with no configuration required. When you run into issues with your app, App Service diagnostics can help you resolve the issue easily and quickly.
-
-You can take advantage of App Service diagnostics when you run load tests on applications that run on App Service.
+[App Service diagnostics](/azure/app-service/overview-diagnostics.md) is an intelligent and interactive way to help troubleshoot your app, with no configuration required. When you run into issues with your app, App Service diagnostics can help you resolve the issue easily and quickly.
 
 > [!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/).
@@ -28,43 +26,47 @@ You can take advantage of App Service diagnostics when you run load tests on app
 - An Azure Load Testing resource. If you need to create an Azure Load Testing resource, see the quickstart [Create and run a load test](./quickstart-create-and-run-load-test.md).
 - An Azure App Service workload that you're running a load test against and that you've added to the app components to monitor during the load test.
 
-## Get more insights when you test an App Service workload  
-
-In this section, you use [App Service diagnostics](../app-service/overview-diagnostics.md) to get more insights from load testing an Azure App Service workload.
+## Use App Service diagnostics for your load test
 
-1. In the [Azure portal](https://portal.azure.com), go to your Azure Load Testing resource.
+Azure Load Testing lets you monitor server-side metrics for your Azure app components for a load test. You can then visualize and analyze these metrics in the Azure Load Testing dashboard.
 
-1. On the left pane, select **Tests** to view the list of tests, and then select your test.
+When the application you're load testing is hosted on Azure App Service, you can get extra insights by using [App Service diagnostics](/azure/app-service/overview-diagnostics.md).
 
-1. On the test runs page, select **Configure**, and then select **App Components** to add or remove Azure resources to monitor during the load test.
+To view the App Service diagnostics information for your application under load test:
 
-    :::image type="content" source="media/how-to-appservice-insights/configure-app-components.png" alt-text="Screenshot that shows the 'Configure' and 'App Components' buttons for configuring the load test.":::  
+1. Go to the [Azure portal](https://portal.azure.com).
 
-1. Select the **Monitoring** tab, and then add your app service to the list of app components to monitor.
+1. Add your App Service resource to the load test app components. Follow the steps in [monitor server-side metrics](./how-to-monitor-server-side-metrics.md) to add your app service.
 
-    :::image type="content" source="media/how-to-appservice-insights/test-monitoring-app-service.png" alt-text="Screenshot of the 'Edit test' pane for selecting and app service resource to monitor.":::  
+    :::image type="content" source="media/how-to-appservice-insights/test-monitoring-app-service.png" alt-text="Screenshot of the Monitoring tab when editing a load test in the Azure portal, highlighting the App Service resource.":::
 
-1. Select **Run** to execute the load test.
+1. Select **Run** to run the load test.
 
     After the test finishes, you'll notice a section about App Service on the test result dashboard.
 
-1. Select the **here** link in the App Service message.
+    :::image type="content" source="media/how-to-appservice-insights/test-result-app-service-diagnostics.png" alt-text="Screenshot that shows the 'App Service' section on the load testing dashboard in the Azure portal.":::
+
+1. Select the link in **Additional insights** to view the App Service diagnostics information.
 
-    :::image type="content" source="media/how-to-appservice-insights/test-result-app-service-diagnostics.png" alt-text="Screenshot that shows the 'App Service' section on the test result dashboard.":::
+    App Service diagnostics enables you to view in-depth information and dashboard about the performance, resource usage, and stability of your app service.
 
-    Your Azure App Service **Availability and Performance** page opens, which displays your App Service diagnostics.
+    In the screenshot, you notice that there are concerns about the CPU usage, app performance, and failed requests.
 
     :::image type="content" source="media/how-to-appservice-insights/app-diagnostics-overview.png" alt-text="Screenshot that shows the App Service diagnostics overview page, with a list of interactive reports on the left pane.":::
 
-1. On the left pane, select any of the various interactive reports that are available in App Service diagnostics.
+    On the left pane, you can drill deeper into specific issues by selecting one the diagnostics reports. For example, the following screenshot shows the **High CPU Analysis** report.
 
     :::image type="content" source="media/how-to-appservice-insights/app-diagnostics-high-cpu.png" alt-text="Screenshot that shows the App Service diagnostics CPU usage report.":::
 
-    > [!IMPORTANT]
+    The following screenshot shows the **Web App Slow** report, which gives details and recommendations about application performance.
+
+    :::image type="content" source="media/how-to-appservice-insights/app-diagnostics-web-app-slow.png" alt-text="Screenshot that shows the App Service diagnostics slow application report.":::
+
+    > [!NOTE]
     > It can take up to 45 minutes for the insights data to be displayed on this page.
 
 ## Next steps
 
-- Learn how to [parameterize a load test](./how-to-parameterize-load-tests.md) with secrets.
-
-- Learn how to [configure automated performance testing](./tutorial-identify-performance-regression-with-cicd.md).
+- Learn how to [parameterize a load test with secrets and environment variables](./how-to-parameterize-load-tests.md).
+- Learn how to [identify performance bottlenecks](./tutorial-identify-bottlenecks-azure-portal.md) for Azure applications.
+- Learn how to [configure automated performance testing](./tutorial-identify-performance-regression-with-cicd.md).