> azure-chaos-studio

Expert knowledge for Chaos Studio development including troubleshooting, limits & quotas, security, configuration, and integrations & coding patterns. Use when defining ARM/Bicep experiments, deploying Chaos Agents, using CLI/REST, or integrating with Azure Monitor, and other Chaos Studio related development tasks. Not for Azure Monitor (use azure-monitor), Azure Resiliency (use azure-resiliency), Azure Reliability (use azure-reliability), Azure Site Recovery (use azure-site-recovery).

fetch

$curl "https://skillshub.wtf/MicrosoftDocs/Agent-Skills/azure-chaos-studio?format=md"

SKILL.md•azure-chaos-studio

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

Category	Lines	Description
Troubleshooting	L33-L40	Diagnosing 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 & Quotas	L41-L48	Chaos Studio limits: agent OS/fault compatibility, known issues, regional/HA behavior, and throttling, quotas, and usage constraints for experiments
Security	L49-L63	Securing Chaos Studio: identities, roles, permissions, CMK encryption, network/IP controls, Private Link, VNet injection, AKS auth, and safely controlling experiment targets/capabilities.
Configuration	L64-L76	Configuring Chaos Studio: ARM/Bicep experiment definitions, deploying agents/targets, parameters, Azure Monitor/Workbook integration, OS/tool compatibility, and onboarding via Azure Policy
Integrations & Coding Patterns	L77-L82	Using 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

Topic	URL
Review known issues and workarounds for Chaos Agent	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 common Azure Chaos Studio issues	https://learn.microsoft.com/en-us/azure/chaos-studio/troubleshooting

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 Chaos Studio limitations and known issues	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-limitations
Understand Chaos Studio regional and HA model	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-region-availability
Azure Chaos Studio throttling and usage limits	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-service-limits

Security

Topic	URL
Allowlist Chaos Studio Relay Bridge Host container image	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 managed identity permissions for Chaos experiments	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
Assign roles for Chaos Studio supported resource types	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
Configure Private Link for Chaos Agent experiments	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-private-link-agent-service
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

Configuration

Topic	URL
Deploy Chaos Agent on VM scale sets with ARM	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
Configure Azure Workbook to measure Chaos Studio faults	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-fault-metrics-and-dashboard
Configure Azure Monitor integration for Chaos Studio	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-set-up-azure-monitor
Check OS and tool compatibility for Chaos Studio	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-versions
Use Azure Policy to onboard resources to Chaos Studio	https://learn.microsoft.com/en-us/azure/chaos-studio/sample-policy-targets
Define Chaos Studio experiments using ARM templates	https://learn.microsoft.com/en-us/azure/chaos-studio/sample-template-experiment
Deploy Chaos Studio targets and capabilities via ARM	https://learn.microsoft.com/en-us/azure/chaos-studio/sample-template-targets

Integrations & Coding Patterns

Topic	URL
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
Create Chaos Studio experiments via CLI and portal	https://learn.microsoft.com/en-us/azure/chaos-studio/experiment-examples

> related_skills --same-repo

> microsoft-foundry

Expert knowledge for Microsoft Foundry (aka Azure AI Foundry) development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building Foundry agents with Azure OpenAI, vector search/RAG, Sora video, realtime audio, or MCP/LangChain APIs, and other Microsoft Foundry related development tasks. Not for Microsoft Foundry Classic (use microsoft-foundry-classic),

> microsoft-foundry-tools

Expert knowledge for Microsoft Foundry Tools (aka Azure AI services, Azure Cognitive Services) development including best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using Content Understanding analyzers, Content Moderator APIs, Foundry containers, VNet/Key Vault security, or Entra auth, and other Microsoft Foundry Tools related development tasks. Not for Microsoft Foundry (use micr

> microsoft-foundry-local

Expert knowledge for Microsoft Foundry Local (aka Azure AI Foundry Local) development including troubleshooting, best practices, decision making, configuration, and integrations & coding patterns. Use when using Foundry Local CLI, chat/transcription APIs, tools, OpenAI/LangChain clients, or upgrading legacy SDKs, and other Microsoft Foundry Local related development tasks. Not for Microsoft Foundry (use microsoft-foundry), Microsoft Foundry Classic (use microsoft-foundry-classic), Microsoft Foun

> microsoft-foundry-classic

Expert knowledge for Microsoft Foundry Classic (aka Azure AI Foundry classic) development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building Foundry agents with RAG, tools, evaluators, Azure OpenAI, VNet/Private Link, or CI/CD deployments, and other Microsoft Foundry Classic related development tasks. Not for Microsoft Foundry (use microsoft-foundry

┌ stats

installs/wk0

░░░░░░░░░░

github stars525

██████████

first seenMar 17, 2026

└────────────

┌ repo

MicrosoftDocs/Agent-Skills

by MicrosoftDocs

└────────────

┌ tags

#azure #security

└────────────