mcpField
A
azure-app-testing

azure-app-testing

github.com/microsoftdocsTesting & quality796171 installsUpdated 3d ago
Repository

About azure-app-testing

azure-app-testing is a guidance skill for Azure App Testing, aimed at agents and developers working with load tests and Playwright Workspaces. It combines local references with network-fetched documentation across troubleshooting, configuration, security, and deployment.

Key features

  1. 01Load testing troubleshooting and best practices
  2. 02Playwright Workspaces guidance
  3. 03Configuration, security, and quota references
  4. 04Architecture and deployment guidance
  5. 05Local index with remote documentation fetching

Use cases

  1. 01Diagnosing failed load tests
  2. 02Planning private-endpoint test architectures
  3. 03Configuring test runs, secrets, and monitoring
  4. 04Automating load tests in CI/CD

MCP support

The skill recommends the mcp_microsoftdocs microsoft_docs_fetch tool to retrieve documentation. Its guidance also covers Playwright Workspaces remote MCP troubleshooting and MCP integrations.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-app-testing

After installing, type/azure-app-testingin Claude Code to confirm it loaded.

Details

From the project README

Azure App Testing Skill

This 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.

How to Use This Skill

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

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

This skill requires network access to fetch documentation content:

  • Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
  • Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

CategoryLinesDescription
TroubleshootingL37-L48Diagnosing and fixing Azure Load Testing issues, including AI-driven insights, debug mode, browser recorder, private endpoints, and Playwright Workspaces (remote MCP, reporting, and test run errors).
Best PracticesL49-L57Guidance on load testing App Service apps, tuning high-scale tests, finding performance bottlenecks, and optimizing Playwright Workspace tests for reliability and low latency.
Decision MakingL58-L65Guides for deciding load test resource moves (regions, groups, subscriptions) and tuning performance settings like Azure Functions configs and Playwright parallelism.
Architecture & Design PatternsL66-L71Designing Azure Load Testing setups with virtual networks and private endpoints, including VNet-injected tests, network isolation, and testing services over private connectivity.
Limits & QuotasL72-L79Usage caps, service limits, and configuration for Azure Load Testing and Playwright Workspaces, including monthly quotas, free trial restrictions, and how to adjust or review these limits.
SecurityL80-L92Securing Azure Load Testing and Playwright Workspaces: RBAC, auth for endpoints, managed identities, Key Vault, CMK encryption, certificates, access tokens, and Azure Policy controls.
ConfigurationL93-L113Configuring 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.
Integrations & Coding PatternsL114-L125Patterns and tools for integrating Azure Load Testing with JMeter, Locust, VS Code/Copilot, CSV data, plugins, and Playwright (including MCP and local/private app testing).
DeploymentL126-L130Setting up and automating CI/CD for Azure Load Testing, including manual pipeline configuration and integration with Azure Pipelines for automated test runs.
Troubleshooting
TopicURL
Use AI-powered actionable insights to diagnose Azure load test issueshttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-analyze-test-results-using-actionable-insights
Diagnose and troubleshoot failing Azure load testshttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-diagnose-failing-load-test
Run Azure load tests in debug mode for troubleshootinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-run-tests-in-debug-mode
Diagnose Azure Load Testing browser recorder issueshttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/troubleshoot-browser-extension
Troubleshoot private endpoint load tests in Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/troubleshoot-private-endpoint-tests
Troubleshoot Playwright Workspaces remote MCP issueshttps://learn.microsoft.com/en-us/azure/app-testing/playwright-cloud-browsers/troubleshoot-remote-mcp-server
Troubleshoot Playwright Workspaces reporting errorshttps://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/troubleshoot-playwright-workspaces-reporting
Troubleshoot Playwright Workspaces test run issueshttps://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/troubleshoot-test-run-failures
Best Practices
TopicURL
Load test Azure App Service apps with Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/concept-load-test-app-service
Configure high-scale load tests and engine instances in Azurehttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-high-scale-load
Identify performance bottlenecks using Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/tutorial-identify-bottlenecks-azure-portal
Configure Playwright visual comparisons in Workspaces reliablyhttps://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/how-to-configure-visual-comparisons
Optimize regional latency for Playwright Workspaces testshttps://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/how-to-optimize-regional-latency
Decision Making
TopicURL
Move Azure Load Testing resources between regionshttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-move-between-regions
Move Azure Load Testing resources across resource groups or subscriptionshttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-move-between-resource-groups-subscriptions
Choose optimal Azure Functions configuration with load testshttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-optimize-azure-functions
Determine optimal Playwright Workspaces parallelism configurationhttps://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/concept-determine-optimal-configuration
Architecture & Design Patterns
TopicURL
Choose virtual network deployment scenarios for Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/concept-azure-load-testing-vnet-injection
Test private endpoints with virtual network–injected Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-test-private-endpoint
Limits & Quotas
TopicURL
Configure monthly usage limits for Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-manage-usage-limits
Service limits and quotas for Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/resource-limits-quotas-capacity
Understand Playwright Workspaces free trial limitshttps://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/how-to-try-playwright-workspaces-free
Review Playwright Workspaces limits and configurationhttps://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/resource-limits-quotas-capacity
Security
TopicURL
Manage Azure Load Testing access with RBAC roleshttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-assign-roles
Configure customer-managed keys for Azure Load Testing encryptionhttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-configure-customer-managed-keys
Load test authenticated endpoints with Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-test-secured-endpoints
Use managed identities and Key Vault with Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-use-a-managed-identity
Secure Azure Load Testing resources with Azure Policyhttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-use-azure-policy
Configure multiple certificates with JKS and Key Vault in Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-use-multiple-certificates
Manage Playwright Workspaces access tokens securelyhttps://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/how-to-manage-access-tokens
Configure authentication and authorization for Playwright Workspaceshttps://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/how-to-manage-authentication
Configure RBAC-based access control for Playwright Workspaceshttps://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/how-to-manage-workspace-access
Configuration
TopicURL
Configure HTTP requests in URL-based Azure load testshttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-add-requests-to-url-based-test
Compare multiple Azure load test runs and baselineshttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-compare-multiple-test-runs
Configure JMeter user properties in Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-configure-user-properties
Create and manage Azure load test definitionshttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-create-manage-test
Create and manage Azure load test runs in the portalhttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-create-manage-test-runs
Configure fail and auto-stop criteria for Azure load testshttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-define-test-criteria
Export Azure Load Testing results for external reportinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-export-test-results
Generate multi-region load with Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-generate-load-from-multiple-regions
Monitor server-side Azure resource metrics during load testshttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-monitor-server-side-metrics
Use secrets and environment variables in Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-parameterize-load-tests
Schedule recurring Azure load testshttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-schedule-tests
Use Azure Load Testing results dashboard for analysishttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-understand-test-run-results-dashboard
Reference for Azure Load Testing monitoring data and resourceshttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/monitor-load-testing-reference
Configure Azure Load Testing with YAML in CI/CDhttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/reference-test-config-yaml
JMeter properties overridden by Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/resource-jmeter-property-overrides
Select supported Azure resources for Load Testing monitoringhttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/resource-supported-azure-resource-types
Use Playwright Workspaces service configuration file optionshttps://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/how-to-use-service-config-file
Integrations & Coding Patterns
TopicURL
Run JMeter-based load tests in Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-create-and-run-load-test-with-jmeter-script
Use CSV data in JMeter and Locust tests on Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-read-csv-data
Use JMeter plugins with Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-use-jmeter-plugins
Create Locust-based load tests in Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/quickstart-create-run-load-test-with-locust
Use VS Code extension and Copilot for Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/quickstart-create-run-load-tests-from-visual-studio-code
Use supported JMeter features in Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/resource-jmeter-support
Integrate AI agents with Playwright MCP serverhttps://learn.microsoft.com/en-us/azure/app-testing/playwright-cloud-browsers/how-to-playwright-workspaces-remote-mcp
Run Playwright Workspaces tests against local or private appshttps://learn.microsoft.com/en-us/azure/app-testing/playwright-workspaces/how-to-test-local-applications
Deployment
TopicURL
Manually configure CI/CD pipelines for Azure Load Testinghttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/how-to-configure-load-test-cicd
Automate Azure Load Testing in Azure Pipelines CI/CDhttps://learn.microsoft.com/en-us/azure/app-testing/load-testing/quickstart-add-load-test-cicd

Comments

Markdown supported