1---2name: azure-app-testing3description: Expert knowledge for Azure App Testing development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using Azure Load Testing with VNets/private endpoints, JMeter/Locust, Playwright Workspaces, CI/CD, or quotas, and other Azure App Testing related development tasks. Not for Azure Test Plans (use azure-test-plans), Azure DevOps (use azure-devops), Azure Pipelines (use azure-pipelines), Azure App Service (use azure-app-service).4---5# Azure App Testing Skill
6
7This skill provides expert guidance for Azure App Testing. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.
8
9## How to Use This Skill
10
11> **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file
12
13> **IMPORTANT for Agent**: If `metadata.generated_at` is more than 3 months old, suggest the user pull the latest version from the repository. If `mcp_microsoftdocs` tools are not available, suggest the user install it: [Installation Guide](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)
14
15This skill requires **network access** to fetch documentation content:
16- **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown.
17- **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown.
18
19## Category Index
20
21| Category | Lines | Description |
22|----------|-------|-------------|
23| Troubleshooting | L37-L47 | Diagnosing and fixing Azure Load Testing issues: failed or flaky tests, debug-mode runs, AI-based insights, browser recorder problems, private endpoint failures, and Playwright workspace/test run errors. |
24| Best Practices | L48-L56 | Guidance on load testing App Service apps, tuning high-scale tests, finding performance bottlenecks, and optimizing Playwright Workspace tests for reliability and low latency. |
25| Decision Making | L57-L64 | Guides for deciding load test resource moves (regions, groups, subscriptions) and tuning performance settings like Azure Functions configs and Playwright parallelism. |
26| Architecture & Design Patterns | L65-L70 | Designing Azure Load Testing setups with virtual networks and private endpoints, including VNet-injected tests, network isolation, and testing services over private connectivity. |
27| Limits & Quotas | L71-L78 | Configuring and understanding usage limits, quotas, and free trial constraints for Azure Load Testing and Playwright Workspaces, including monthly caps and workspace configuration options. |
28| Security | L79-L91 | Securing Azure Load Testing and Playwright Workspaces: RBAC, auth for endpoints, managed identities, Key Vault, CMK encryption, certificates, access tokens, and Azure Policy controls. |
29| Configuration | L92-L113 | Configuring and running Azure Load Testing and Playwright Workspaces: test definitions, HTTP/JMeter settings, secrets, monitoring, baselines, reporting/export, CI/CD YAML, scheduling, and multi-region load. |
30| Integrations & Coding Patterns | L114-L124 | Authoring and running load tests with JMeter, Locust, and Playwright, using CSV data and plugins, integrating with VS Code/Copilot, and testing local or private apps via Azure Load Testing. |
31| Deployment | L125-L129 | Setting up and automating CI/CD for Azure Load Testing, including manual pipeline configuration and integration with Azure Pipelines for automated test runs. |
32
33### Troubleshooting
34| Topic | URL |
35|-------|-----|
36| Use AI-powered actionable insights to diagnose Azure load test issues | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-analyze-test-results-using-actionable-insights |
37| Diagnose and troubleshoot failing Azure load tests | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-diagnose-failing-load-test |
38| Run Azure load tests in debug mode for troubleshooting | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-run-tests-in-debug-mode |
39| Diagnose Azure Load Testing browser recorder issues | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/troubleshoot-browser-extension |
40| Troubleshoot private endpoint load tests in Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/troubleshoot-private-endpoint-tests |
41| Troubleshoot Playwright Workspaces reporting errors | https://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/troubleshoot-playwright-workspaces-reporting |
42| Troubleshoot Playwright Workspaces test run issues | https://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/troubleshoot-test-run-failures |
43
44### Best Practices
45| Topic | URL |
46|-------|-----|
47| Load test Azure App Service apps with Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/concept-load-test-app-service |
48| Configure high-scale load tests and engine instances in Azure | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-high-scale-load |
49| Identify performance bottlenecks using Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/tutorial-identify-bottlenecks-azure-portal |
50| Configure Playwright visual comparisons in Workspaces reliably | https://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/how-to-configure-visual-comparisons |
51| Optimize regional latency for Playwright Workspaces tests | https://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/how-to-optimize-regional-latency |
52
53### Decision Making
54| Topic | URL |
55|-------|-----|
56| Move Azure Load Testing resources between regions | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-move-between-regions |
57| Move Azure Load Testing resources across resource groups or subscriptions | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-move-between-resource-groups-subscriptions |
58| Choose optimal Azure Functions configuration with load tests | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-optimize-azure-functions |
59| Determine optimal Playwright Workspaces parallelism configuration | https://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/concept-determine-optimal-configuration |
60
61### Architecture & Design Patterns
62| Topic | URL |
63|-------|-----|
64| Choose virtual network deployment scenarios for Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/concept-azure-load-testing-vnet-injection |
65| Test private endpoints with virtual network–injected Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-test-private-endpoint |
66
67### Limits & Quotas
68| Topic | URL |
69|-------|-----|
70| Configure monthly usage limits for Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-manage-usage-limits |
71| Service limits and quotas for Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/resource-limits-quotas-capacity |
72| Understand Playwright Workspaces free trial limits | https://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/how-to-try-playwright-workspaces-free |
73| Review limits and configuration for Playwright Workspaces | https://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/resource-limits-quotas-capacity |
74
75### Security
76| Topic | URL |
77|-------|-----|
78| Manage Azure Load Testing access with RBAC roles | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-assign-roles |
79| Configure customer-managed keys for Azure Load Testing encryption | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-configure-customer-managed-keys |
80| Load test authenticated endpoints with Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-test-secured-endpoints |
81| Use managed identities and Key Vault with Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-use-a-managed-identity |
82| Secure Azure Load Testing resources with Azure Policy | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-use-azure-policy |
83| Configure multiple certificates with JKS and Key Vault in Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-use-multiple-certificates |
84| Manage Playwright Workspaces access tokens securely | https://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/how-to-manage-access-tokens |
85| Configure authentication and authorization for Playwright Workspaces | https://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/how-to-manage-authentication |
86| Configure RBAC-based access control for Playwright Workspaces | https://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/how-to-manage-workspace-access |
87
88### Configuration
89| Topic | URL |
90|-------|-----|
91| Configure HTTP requests in URL-based Azure load tests | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-add-requests-to-url-based-test |
92| Compare multiple Azure load test runs and baselines | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-compare-multiple-test-runs |
93| Configure JMeter user properties in Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-configure-user-properties |
94| Create and manage Azure load test definitions | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-create-manage-test |
95| Create and manage Azure load test runs in the portal | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-create-manage-test-runs |
96| Configure fail and auto-stop criteria for Azure load tests | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-define-test-criteria |
97| Export Azure Load Testing results for external reporting | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-export-test-results |
98| Generate multi-region load with Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-generate-load-from-multiple-regions |
99| Monitor server-side Azure resource metrics during load tests | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-monitor-server-side-metrics |
100| Use secrets and environment variables in Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-parameterize-load-tests |
101| Schedule recurring Azure load tests | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-schedule-tests |
102| Use Azure Load Testing results dashboard for analysis | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-understand-test-run-results-dashboard |
103| Reference for Azure Load Testing monitoring data and resources | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/monitor-load-testing-reference |
104| Configure Azure Load Testing with YAML in CI/CD | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/reference-test-config-yaml |
105| JMeter properties overridden by Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/resource-jmeter-property-overrides |
106| Select supported Azure resources for Load Testing monitoring | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/resource-supported-azure-resource-types |
107| Use Playwright Workspaces service configuration file options | https://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/how-to-use-service-config-file |
108| Configure Playwright Workspaces reporting for advanced diagnostics | https://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/quickstart-advanced-diagnostic-with-playwright-workspaces-reporting |
109
110### Integrations & Coding Patterns
111| Topic | URL |
112|-------|-----|
113| Run JMeter-based load tests in Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-create-and-run-load-test-with-jmeter-script |
114| Use CSV data in JMeter and Locust tests on Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-read-csv-data |
115| Use JMeter plugins with Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-use-jmeter-plugins |
116| Create Locust-based load tests in Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/quickstart-create-run-load-test-with-locust |
117| Use VS Code extension and Copilot for Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/quickstart-create-run-load-tests-from-visual-studio-code |
118| Use supported JMeter features in Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/resource-jmeter-support |
119| Run Playwright Workspaces tests against local or private apps | https://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/how-to-test-local-applications |
120
121### Deployment
122| Topic | URL |
123|-------|-----|
124| Manually configure CI/CD pipelines for Azure Load Testing | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-configure-load-test-cicd |
125| Automate Azure Load Testing in Azure Pipelines CI/CD | https://learn.microsoft.com/en-us/azure/app-testing/load-testing/quickstart-add-load-test-cicd |
microsoftdocs