{"id":"aef4ce33-17ec-4d0c-9cc1-2bdff81d2ed3","shortId":"5Z9aze","kind":"skill","title":"azure-chaos-studio","tagline":"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 Cha","description":"# Chaos Studio Skill\n\nThis 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.\n\n## How to Use This Skill\n\n> **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\n\n> **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)\n\nThis skill requires **network access** to fetch documentation content:\n- **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown.\n- **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown.\n\n## Category Index\n\n| Category | Lines | Description |\n|----------|-------|-------------|\n| 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. |\n| Limits & Quotas | L41-L48 | Chaos Studio limits: agent OS/fault compatibility, known issues, regional/HA behavior, and throttling, quotas, and usage constraints for experiments |\n| 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. |\n| 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 |\n| 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 |\n\n### Troubleshooting\n| Topic | URL |\n|-------|-----|\n| Review known issues and workarounds for Chaos Agent | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-known-issues |\n| Troubleshoot Azure Chaos Agent installation and health | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-troubleshooting |\n| Verify and interpret Chaos Agent status on VMs | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-verify-status |\n| Troubleshoot common Azure Chaos Studio issues | https://learn.microsoft.com/en-us/azure/chaos-studio/troubleshooting |\n\n### Limits & Quotas\n| Topic | URL |\n|-------|-----|\n| Check OS and fault compatibility for Chaos Agent | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-os-support |\n| Review Chaos Studio limitations and known issues | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-limitations |\n| Understand Chaos Studio regional and HA model | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-region-availability |\n| Azure Chaos Studio throttling and usage limits | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-service-limits |\n\n### Security\n| Topic | URL |\n|-------|-----|\n| Allowlist Chaos Studio Relay Bridge Host container image | https://learn.microsoft.com/en-us/azure/chaos-studio/azure-container-instance-details |\n| Understand Chaos Agent networking, identity, and dependencies | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-concepts |\n| Configure Entra authentication for Chaos Studio AKS faults | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-aks-authentication |\n| Authorize Chaos Studio IP ranges for AKS clusters | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-aks-ip-ranges |\n| Assign managed identity permissions for Chaos experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-assign-experiment-permissions |\n| Configure customer-managed keys for Chaos Studio experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-configure-customer-managed-keys |\n| Assign roles for Chaos Studio supported resource types | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-fault-providers |\n| Configure permissions and security for Azure Chaos Studio | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-permissions-security |\n| Configure Private Link for Chaos Agent experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-private-link-agent-service |\n| Secure Chaos Studio with virtual network injection | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-private-networking |\n| Control Chaos Studio targets and capabilities securely | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-targets-capabilities |\n\n### Configuration\n| Topic | URL |\n|-------|-----|\n| Deploy Chaos Agent on VM scale sets with ARM | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-arm-template |\n| Author Chaos Studio experiments with Bicep templates | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-bicep |\n| Use Chaos Studio fault and action parameters | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-fault-library |\n| Configure Azure Workbook to measure Chaos Studio faults | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-fault-metrics-and-dashboard |\n| Configure Azure Monitor integration for Chaos Studio | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-set-up-azure-monitor |\n| Check OS and tool compatibility for Chaos Studio | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-versions |\n| Use Azure Policy to onboard resources to Chaos Studio | https://learn.microsoft.com/en-us/azure/chaos-studio/sample-policy-targets |\n| Define Chaos Studio experiments using ARM templates | https://learn.microsoft.com/en-us/azure/chaos-studio/sample-template-experiment |\n| Deploy Chaos Studio targets and capabilities via ARM | https://learn.microsoft.com/en-us/azure/chaos-studio/sample-template-targets |\n\n### Integrations & Coding Patterns\n| Topic | URL |\n|-------|-----|\n| Call Azure Chaos Studio REST APIs with CLI samples | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-samples-rest-api |\n| Send Chaos Agent experiment telemetry to App Insights | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-set-up-app-insights |\n| Create Chaos Studio experiments via CLI and portal | https://learn.microsoft.com/en-us/azure/chaos-studio/experiment-examples |","tags":["azure","chaos","studio","agent","skills","microsoftdocs","agent-skills","agentic-skills","agentskill","ai-agents","ai-coding","azure-functions"],"capabilities":["skill","source-microsoftdocs","skill-azure-chaos-studio","topic-agent","topic-agent-skills","topic-agentic-skills","topic-agentskill","topic-ai-agents","topic-ai-coding","topic-azure","topic-azure-functions","topic-azure-kubernetes-service","topic-azure-openai","topic-azure-sql-database","topic-azure-storage"],"categories":["Agent-Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/MicrosoftDocs/Agent-Skills/azure-chaos-studio","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add MicrosoftDocs/Agent-Skills","source_repo":"https://github.com/MicrosoftDocs/Agent-Skills","install_from":"skills.sh"}},"qualityScore":"0.698","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 497 github stars · SKILL.md body (6,983 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T06:53:29.198Z","embedding":null,"createdAt":"2026-04-18T21:58:26.028Z","updatedAt":"2026-04-22T06:53:29.198Z","lastSeenAt":"2026-04-22T06:53:29.198Z","tsv":"'/en-us/azure/chaos-studio/azure-container-instance-details':439 '/en-us/azure/chaos-studio/chaos-agent-arm-template':560 '/en-us/azure/chaos-studio/chaos-agent-concepts':449 '/en-us/azure/chaos-studio/chaos-agent-known-issues':350 '/en-us/azure/chaos-studio/chaos-agent-os-support':395 '/en-us/azure/chaos-studio/chaos-agent-troubleshooting':360 '/en-us/azure/chaos-studio/chaos-agent-verify-status':371 '/en-us/azure/chaos-studio/chaos-studio-aks-authentication':460 '/en-us/azure/chaos-studio/chaos-studio-aks-ip-ranges':471 '/en-us/azure/chaos-studio/chaos-studio-assign-experiment-permissions':481 '/en-us/azure/chaos-studio/chaos-studio-bicep':570 '/en-us/azure/chaos-studio/chaos-studio-configure-customer-managed-keys':493 '/en-us/azure/chaos-studio/chaos-studio-fault-library':580 '/en-us/azure/chaos-studio/chaos-studio-fault-metrics-and-dashboard':591 '/en-us/azure/chaos-studio/chaos-studio-fault-providers':504 '/en-us/azure/chaos-studio/chaos-studio-limitations':405 '/en-us/azure/chaos-studio/chaos-studio-permissions-security':515 '/en-us/azure/chaos-studio/chaos-studio-private-link-agent-service':525 '/en-us/azure/chaos-studio/chaos-studio-private-networking':535 '/en-us/azure/chaos-studio/chaos-studio-region-availability':415 '/en-us/azure/chaos-studio/chaos-studio-samples-rest-api':662 '/en-us/azure/chaos-studio/chaos-studio-service-limits':425 '/en-us/azure/chaos-studio/chaos-studio-set-up-app-insights':673 '/en-us/azure/chaos-studio/chaos-studio-set-up-azure-monitor':601 '/en-us/azure/chaos-studio/chaos-studio-targets-capabilities':545 '/en-us/azure/chaos-studio/chaos-studio-versions':612 '/en-us/azure/chaos-studio/experiment-examples':684 '/en-us/azure/chaos-studio/sample-policy-targets':624 '/en-us/azure/chaos-studio/sample-template-experiment':634 '/en-us/azure/chaos-studio/sample-template-targets':645 '/en-us/azure/chaos-studio/troubleshooting':380 '/microsoftdocs/mcp/blob/main/readme.md)':159 '3':130 'accept':198 'access':164 'action':576 'agent':28,79,123,182,196,218,224,243,326,347,354,365,392,442,521,551,665 'agents/targets':294 'ak':276,456,467 'allowlist':429 'api':656 'app':669 'applic':329 'arm':557,630,642 'arm/bicep':24,290 'assign':472,494 'auth':277 'authent':452 'author':461,561 'autom':335 'avail':149 'azur':2,34,296,304,352,374,416,510,582,593,614,652 'azure-chaos-studio':1 'behavior':249 'bicep':566 'bridg':433 'call':651 'capabl':71,541,640 'categori':82,90,106,202,204 'cha':38 'chao':3,8,27,39,48,214,217,240,263,288,318,325,346,353,364,375,391,397,407,417,430,441,454,462,477,488,497,511,520,527,537,550,562,572,586,597,608,620,626,636,653,664,675 'check':226,385,602 'cli':658,679 'cli/rest':30,313 'cluster':468 'cmk':268 'code':19,58,307,647 'combin':61 'common':230,373 'compat':245,300,389,606 'configur':16,55,283,287,450,482,505,516,546,581,592 'connect':233 'constraint':255 'contain':435 'content':66,168 'control':271,280,536 'cover':50 'creat':315,674 'custom':484 'customer-manag':483 'defin':23,625 'definit':292 'depend':446 'deploy':26,293,549,635 'descript':206 'develop':10 'diagnos':211 'doc':174 'document':69,167 'e.g':94,110 'encrypt':269 'entra':451 'error':228 'experi':25,231,257,281,291,320,333,478,490,522,564,628,666,677 'expert':5,45 'failur':234 'fallback':186 'fault':388,457,574,588 'fetch':70,166,175,188 'file':100,108,115,120 'fix':213 'github.com':158 'github.com/microsoftdocs/mcp/blob/main/readme.md)':157 'guid':156 'guidanc':46 'ha':411 'health':357 'host':434 'ident':265,444,474 'imag':436 'import':77,121 'includ':11,220 'index':83,203 'inject':275,532 'insight':330,670 'instal':153,155,355 'installation/health':221 'integr':18,32,57,298,306,332,595,646 'interpret':363 'ip':464 'issu':219,247,342,377,402 'key':486 'knowledg':6 'known':227,246,341,401 'l120':97 'l33':209 'l33-l40':208 'l35':96 'l35-l120':95 'l40':210 'l41':238 'l41-l48':237 'l48':239 'l49':260 'l49-l63':259 'l63':261 'l64':285 'l64-l76':284 'l76':286 'l77':310 'l77-l82':309 'l82':311 'latest':138 'learn':181,195 'learn-agent-skil':180,194 'learn.microsoft.com':349,359,370,379,394,404,414,424,438,448,459,470,480,492,503,514,524,534,544,559,569,579,590,600,611,623,633,644,661,672,683 'learn.microsoft.com/en-us/azure/chaos-studio/azure-container-instance-details':437 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-arm-template':558 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-concepts':447 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-known-issues':348 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-os-support':393 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-troubleshooting':358 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-verify-status':369 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-aks-authentication':458 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-aks-ip-ranges':469 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-assign-experiment-permissions':479 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-bicep':568 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-configure-customer-managed-keys':491 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-fault-library':578 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-fault-metrics-and-dashboard':589 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-fault-providers':502 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-limitations':403 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-permissions-security':513 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-private-link-agent-service':523 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-private-networking':533 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-region-availability':413 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-samples-rest-api':660 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-service-limits':423 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-set-up-app-insights':671 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-set-up-azure-monitor':599 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-targets-capabilities':543 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-versions':610 'learn.microsoft.com/en-us/azure/chaos-studio/experiment-examples':682 'learn.microsoft.com/en-us/azure/chaos-studio/sample-policy-targets':622 'learn.microsoft.com/en-us/azure/chaos-studio/sample-template-experiment':632 'learn.microsoft.com/en-us/azure/chaos-studio/sample-template-targets':643 'learn.microsoft.com/en-us/azure/chaos-studio/troubleshooting':378 'limit':13,52,235,242,381,399,422 'line':92,104,205 'link':109,118,273,518 'local':62 'locat':86 'manag':317,473,485 'markdown':185,201 'mcp':144,171 'measur':585 'metadata.generated':125 'microsoft':173 'microsoftdoc':145,172 'model':412 'monitor':35,594 'monitor/workbook':297 'month':131 'network':163,443,531 'network/ip':270 'old':132 'onboard':302,617 'os':386,603 'os/fault':244 'os/tool':299 'paramet':295,577 'pattern':20,59,308,322,648 'permiss':267,475,506 'plus':321 'polici':305,615 'portal':681 'prefer':169 'privat':272,517 'problem':222 'provid':44 'pull':136 'queri':177,191 'quick':64 'quick-refer':63 'quota':14,53,236,252,382 'rang':93,465 'read':99,114 'refer':65,119 'region':409 'regional/ha':248 'relay':432 'relev':87 'remot':68 'repositori':142 'requir':162 'resourc':500,618 'rest':655 'return':184,200 'review':340,396 'role':266,495 'safe':279 'sampl':659 'scale':554 'section':88 'secur':15,54,258,262,426,508,526,542 'security.md':111,112 'send':324,663 'set':555 'skill':41,43,76,161,183,197 'skill-azure-chaos-studio' 'source-microsoftdocs' 'specifi':103 'status':225,366 'string':178,192 'studio':4,9,40,49,215,241,264,289,319,376,398,408,418,431,455,463,489,498,512,528,538,563,573,587,598,609,621,627,637,654,676 'suggest':133,150 'support':499 'target':539,638 'targets/capabilities':282 'telemetri':327,667 'templat':567,631 'text/markdown':199 'throttl':251,419 'tool':146,605 'topic':338,383,427,547,649 'topic-agent' 'topic-agent-skills' 'topic-agentic-skills' 'topic-agentskill' 'topic-ai-agents' 'topic-ai-coding' 'topic-azure' 'topic-azure-functions' 'topic-azure-kubernetes-service' 'topic-azure-openai' 'topic-azure-sql-database' 'topic-azure-storage' 'troubleshoot':12,51,207,337,351,372 'type':501 'understand':406,440 'url':339,384,428,548,650 'usag':254,421 'use':21,29,74,80,98,113,170,187,312,571,613,629 'user':135,152 'verifi':361 'version':139 'via':303,641,678 'virtual':530 'vm':223,553 'vms':368 'vnet':274 'webpag':189 'workaround':344 'workbook':583 'workflow':336","prices":[{"id":"268916db-2505-454e-a743-9d4c8304f6cd","listingId":"aef4ce33-17ec-4d0c-9cc1-2bdff81d2ed3","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"MicrosoftDocs","category":"Agent-Skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:58:26.028Z"}],"sources":[{"listingId":"aef4ce33-17ec-4d0c-9cc1-2bdff81d2ed3","source":"github","sourceId":"MicrosoftDocs/Agent-Skills/azure-chaos-studio","sourceUrl":"https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-chaos-studio","isPrimary":false,"firstSeenAt":"2026-04-18T21:58:26.028Z","lastSeenAt":"2026-04-22T06:53:29.198Z"}],"details":{"listingId":"aef4ce33-17ec-4d0c-9cc1-2bdff81d2ed3","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"MicrosoftDocs","slug":"azure-chaos-studio","github":{"repo":"MicrosoftDocs/Agent-Skills","stars":497,"topics":["agent","agent-skills","agentic-skills","agentskill","ai","ai-agents","ai-coding","azure","azure-functions","azure-kubernetes-service","azure-openai","azure-sql-database","azure-storage","azure-virtual-machine","claude-code","github-copilot","microsoft-learn","openai-codex","skills"],"license":"cc-by-4.0","html_url":"https://github.com/MicrosoftDocs/Agent-Skills","pushed_at":"2026-04-22T01:37:27Z","description":"Curated Agent Skills for Microsoft & Azure – giving AI coding assistants structured, real-time expertise from Microsoft Learn docs.","skill_md_sha":"401d257a819c61158bac05ba9242352a58857659","skill_md_path":"skills/azure-chaos-studio/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-chaos-studio"},"layout":"multi","source":"github","category":"Agent-Skills","frontmatter":{"name":"azure-chaos-studio","description":"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).","compatibility":"Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation."},"skills_sh_url":"https://skills.sh/MicrosoftDocs/Agent-Skills/azure-chaos-studio"},"updatedAt":"2026-04-22T06:53:29.198Z"}}