Azure chaos studio

Chaos Studio Skill

This skill provides expert guidance for Chaos Studio. Covers troubleshooting, best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. 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

Category	Lines	Description
Troubleshooting	L35-L43	Diagnosing and fixing Chaos Agent install/health issues, interpreting agent status on VMs, and troubleshooting Chaos Studio workspaces, scenarios, and experiment failures
Best Practices	L44-L48	Guidance for designing and running Chaos Studio experiments to validate and improve Azure Kubernetes Service (AKS) workload resiliency under failure scenarios.
Decision Making	L49-L53	Guidance on when to use Chaos Studio workspaces vs experiments, how they differ, and how to choose the right structure for organizing and running chaos tests.
Limits & Quotas	L54-L61	Chaos Studio limits, quotas, throttling, OS/fault compatibility, and version support details for agents and experiments.
Security	L62-L76	Security, identity, and access control for Chaos Studio: RBAC roles, workspace/experiment permissions, AKS auth/IPs, CMK encryption, VNet injection, relay/agent networking, and secure target control.
Configuration	L77-L87	Authoring and deploying Chaos Studio experiments and agents with ARM/Bicep, configuring targets/capabilities, parameters, Private Link, and Azure Policy-based auto-onboarding.
Integrations & Coding Patterns	L88-L95	Using CLI/REST to create and manage Chaos Studio workspaces/experiments, plus patterns for sending experiment and agent telemetry to Azure Monitor and Application Insights.

Troubleshooting

Topic	URL
Resolve Azure Chaos Agent known issues and workarounds	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-known-issues
Troubleshoot Azure Chaos Agent installation and health	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-troubleshooting
Verify and interpret Chaos Agent status on VMs	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-verify-status
Troubleshoot Azure Chaos Studio workspaces and scenarios	https://learn.microsoft.com/en-us/azure/chaos-studio/troubleshoot-workspaces-scenarios
Troubleshoot common Azure Chaos Studio experiment issues	https://learn.microsoft.com/en-us/azure/chaos-studio/troubleshooting

Best Practices

Topic	URL
Test AKS workload resiliency with Chaos Studio	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-aks-guidance

Decision Making

Topic	URL
Choose between Chaos Studio workspaces and experiments	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-workspaces-vs-experiments

Limits & Quotas

Topic	URL
Check OS and fault compatibility for Chaos Agent	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-os-support
Review Azure Chaos Studio limitations and constraints	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-limitations
Azure Chaos Studio throttling and usage limits	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-service-limits
Azure Chaos Studio version and compatibility matrix	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-versions

Security

Topic	URL
Use Chaos Studio Relay Bridge Host container image securely	https://learn.microsoft.com/en-us/azure/chaos-studio/azure-container-instance-details
Understand Chaos Agent networking, identity, and dependencies	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-concepts
Configure Entra authentication for Chaos Studio AKS faults	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-aks-authentication
Authorize Chaos Studio IP ranges for AKS clusters	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-aks-ip-ranges
Assign experiment permissions and roles in Azure Chaos Studio	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-assign-experiment-permissions
Configure customer-managed keys for Chaos Studio experiments	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-configure-customer-managed-keys
Map Chaos Studio fault targets to required Azure roles	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-fault-providers
Configure permissions and security for Azure Chaos Studio	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-permissions-security
Secure Chaos Studio with virtual network injection	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-private-networking
Control Chaos Studio targets and capabilities securely	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-targets-capabilities
Configure RBAC and identities for Chaos Studio workspaces	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-workspace-permissions

Configuration

Topic	URL
Deploy and configure Chaos Agent via ARM templates	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-arm-template
Author Chaos Studio experiments with Bicep templates	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-bicep
Use Chaos Studio fault and action parameters	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-fault-library
Set up Private Link for Chaos Studio agent experiments	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-private-link-agent-service
Configure Azure Policy to auto-add Chaos Studio targets	https://learn.microsoft.com/en-us/azure/chaos-studio/sample-policy-targets
Define Chaos Studio experiments with ARM templates	https://learn.microsoft.com/en-us/azure/chaos-studio/sample-template-experiment
Use ARM templates to configure Chaos Studio targets and capabilities	https://learn.microsoft.com/en-us/azure/chaos-studio/sample-template-targets

Integrations & Coding Patterns

Topic	URL
Manage Chaos Studio workspaces via Azure CLI	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-manage-cli
Call Azure Chaos Studio REST APIs with CLI samples	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-samples-rest-api
Send Chaos Agent experiment telemetry to App Insights	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-set-up-app-insights
Integrate Azure Monitor telemetry with Chaos Studio experiments	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-set-up-azure-monitor
Create Chaos Studio experiments via CLI and portal	https://learn.microsoft.com/en-us/azure/chaos-studio/experiment-examples