Skip to content
azure-chaos-studio logo

Chaos Studio Skill

azure-chaos-studio

Expert knowledge for Chaos Studio development including troubleshooting, limits & quotas, security, configuration, and integrations & coding patterns. Use when creating Chaos Studio experiments via ARM/CLI, configuring Chaos Agent, Azure Monitor, Private Link, or AKS targets, and other Chaos Stud...

MicrosoftDocs/Agent-Skills0installs772stars

SKILL.md

Full skill instructions

Chaos Studio Skill

This skill provides expert guidance for Chaos Studio. Covers troubleshooting, 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

CategoryLinesDescription
TroubleshootingL33-L40Diagnosing and fixing Chaos Studio and Chaos Agent issues, including installation/​health problems, VM agent status checks, known errors, and common experiment or connectivity failures.
Limits & QuotasL41-L48Chaos Studio limits: agent OS/​fault compatibility, known issues, regional/​HA behavior, and throttling, quotas, and usage constraints for experiments
SecurityL49-L63Securing Chaos Studio: identities, roles, permissions, CMK encryption, network/​IP controls, Private Link, VNet injection, AKS auth, and safely controlling experiment targets/​capabilities.
ConfigurationL64-L76Authoring and deploying Chaos Studio experiments and targets with ARM/​Bicep, configuring agents, policies, monitoring (Azure Monitor, Workbooks), and checking OS/​tool compatibility.
Integrations & Coding PatternsL77-L82Using CLI/​REST to create and manage Chaos Studio experiments, plus patterns for sending Chaos Agent telemetry to Application Insights and integrating experiments into automated workflows

Troubleshooting

TopicURL
Review known issues and workarounds for Chaos Agenthttps://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-known-issues
Troubleshoot Azure Chaos Agent installation and healthhttps://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-troubleshooting
Verify and interpret Chaos Agent status on VMshttps://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-verify-status
Troubleshoot common Azure Chaos Studio issueshttps://learn.microsoft.com/en-us/azure/chaos-studio/troubleshooting

Limits & Quotas

Security

TopicURL
Allowlist Chaos Studio Relay Bridge Host container imagehttps://learn.microsoft.com/en-us/azure/chaos-studio/azure-container-instance-details
Understand Chaos Agent networking, identity, and dependencieshttps://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-concepts
Configure Entra authentication for Chaos Studio AKS faultshttps://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-aks-authentication
Authorize Chaos Studio IP ranges for AKS clustershttps://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-aks-ip-ranges
Assign managed identity permissions for Chaos experimentshttps://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-assign-experiment-permissions
Configure customer-managed keys for Chaos Studio experimentshttps://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-configure-customer-managed-keys
Assign roles for Chaos Studio supported resource typeshttps://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-fault-providers
Configure permissions and security for Azure Chaos Studiohttps://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-permissions-security
Configure Private Link for Chaos Agent experimentshttps://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-private-link-agent-service
Secure Chaos Studio with virtual network injectionhttps://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-private-networking
Control Chaos Studio targets and capabilities securelyhttps://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-targets-capabilities

Configuration

Integrations & Coding Patterns

TopicURL
Call Azure Chaos Studio REST APIs with CLI sampleshttps://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-samples-rest-api
Send Chaos Agent experiment telemetry to App Insightshttps://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-set-up-app-insights
Create Chaos Studio experiments via CLI and portalhttps://learn.microsoft.com/en-us/azure/chaos-studio/experiment-examples