{"id":"c3874dce-2788-4ba6-96ce-04583ff203f4","shortId":"ZgRxpG","kind":"skill","title":"azure-service-health","tagline":"Expert knowledge for Azure Service Health development including troubleshooting, limits & quotas, security, configuration, and integrations & coding patterns. Use when integrating Service Health via APIs/webhooks, configuring alerts, querying Resource Graph, or diagnosing VM heal","description":"# Azure Service Health Skill\n\nThis skill provides expert guidance for Azure Service Health. 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-L37 | Understanding VM Resource Health annotations, diagnosing VM health issues, and troubleshooting platform or user-caused VM availability and performance problems |\n| Limits & Quotas | L38-L42 | Details on how long Azure Service Health notifications are kept, their lifecycle stages, and retention behavior for different event types |\n| Security | L43-L51 | Managing who can see Azure Service Health and security advisories using tenant admin roles, RBAC, and subscription vs tenant-level access configuration |\n| Configuration | L52-L60 | Configuring Azure Service Health and Resource Health alerts via ARM/Bicep/PowerShell, and querying health events using Azure Resource Graph tables and Kusto queries |\n| Integrations & Coding Patterns | L61-L70 | Using APIs, Resource Graph, webhooks, and connectors (OpsGenie, PagerDuty, ServiceNow) to query, route, and integrate Azure Service Health and Security advisories into external systems |\n\n### Troubleshooting\n| Topic | URL |\n|-------|-----|\n| Interpret and troubleshoot VM Resource Health annotations | https://learn.microsoft.com/en-us/azure/service-health/resource-health-vm-annotation |\n\n### Limits & Quotas\n| Topic | URL |\n|-------|-----|\n| Understand lifecycle and retention of Service Health notifications | https://learn.microsoft.com/en-us/azure/service-health/service-health-notification-transitions |\n\n### Security\n| Topic | URL |\n|-------|-----|\n| Understand tenant admin roles for Service Health access | https://learn.microsoft.com/en-us/azure/service-health/admin-access-reference |\n| Use RBAC roles to access Azure Service Health history | https://learn.microsoft.com/en-us/azure/service-health/health-history-overview |\n| Configure subscription access for Azure Security advisories | https://learn.microsoft.com/en-us/azure/service-health/security-advisories-add-subscription |\n| Access and view Azure Service Health security advisories | https://learn.microsoft.com/en-us/azure/service-health/security-advisories-elevated-access |\n| Configure tenant vs subscription access for Service Health | https://learn.microsoft.com/en-us/azure/service-health/subscription-vs-tenant |\n\n### Configuration\n| Topic | URL |\n|-------|-----|\n| Define Service Health alert rules using ARM templates | https://learn.microsoft.com/en-us/azure/service-health/alerts-activity-log-service-notifications-arm |\n| Configure Service Health activity log alerts with Bicep | https://learn.microsoft.com/en-us/azure/service-health/alerts-activity-log-service-notifications-bicep |\n| Understand Azure Resource Graph tables for Service Health | https://learn.microsoft.com/en-us/azure/service-health/azure-resource-graph-overview |\n| Use Azure Resource Graph queries for Service Health data | https://learn.microsoft.com/en-us/azure/service-health/resource-graph-samples |\n| Configure Resource Health alerts with PowerShell and ARM templates | https://learn.microsoft.com/en-us/azure/service-health/resource-health-alert-powershell-template |\n\n### Integrations & Coding Patterns\n| Topic | URL |\n|-------|-----|\n| Access Azure Security advisories via API endpoint | https://learn.microsoft.com/en-us/azure/service-health/access-service-advisories-api |\n| Run Azure Resource Graph queries for Resource Health | https://learn.microsoft.com/en-us/azure/service-health/resource-graph-health-samples |\n| Query Azure Service Health impacted resources with ARG | https://learn.microsoft.com/en-us/azure/service-health/resource-graph-impacted-samples |\n| Integrate Azure Service Health alerts via webhooks | https://learn.microsoft.com/en-us/azure/service-health/service-health-alert-webhook-guide |\n| Forward Azure Service Health alerts to OpsGenie | https://learn.microsoft.com/en-us/azure/service-health/service-health-alert-webhook-opsgenie |\n| Integrate Azure Service Health alerts with PagerDuty webhooks | https://learn.microsoft.com/en-us/azure/service-health/service-health-alert-webhook-pagerduty |\n| Send Azure Service Health alerts to ServiceNow | https://learn.microsoft.com/en-us/azure/service-health/service-health-alert-webhook-servicenow |","tags":["azure","service","health","agent","skills","microsoftdocs","agent-skills","agentic-skills","agentskill","ai-agents","ai-coding","azure-functions"],"capabilities":["skill","source-microsoftdocs","skill-azure-service-health","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-service-health","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 (5,424 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-22T00:53:37.477Z","embedding":null,"createdAt":"2026-04-18T22:00:06.995Z","updatedAt":"2026-04-22T00:53:37.477Z","lastSeenAt":"2026-04-22T00:53:37.477Z","tsv":"'/en-us/azure/service-health/access-service-advisories-api':501 '/en-us/azure/service-health/admin-access-reference':382 '/en-us/azure/service-health/alerts-activity-log-service-notifications-arm':440 '/en-us/azure/service-health/alerts-activity-log-service-notifications-bicep':451 '/en-us/azure/service-health/azure-resource-graph-overview':462 '/en-us/azure/service-health/health-history-overview':394 '/en-us/azure/service-health/resource-graph-health-samples':512 '/en-us/azure/service-health/resource-graph-impacted-samples':523 '/en-us/azure/service-health/resource-graph-samples':474 '/en-us/azure/service-health/resource-health-alert-powershell-template':486 '/en-us/azure/service-health/resource-health-vm-annotation':353 '/en-us/azure/service-health/security-advisories-add-subscription':404 '/en-us/azure/service-health/security-advisories-elevated-access':415 '/en-us/azure/service-health/service-health-alert-webhook-guide':533 '/en-us/azure/service-health/service-health-alert-webhook-opsgenie':543 '/en-us/azure/service-health/service-health-alert-webhook-pagerduty':554 '/en-us/azure/service-health/service-health-alert-webhook-servicenow':564 '/en-us/azure/service-health/service-health-notification-transitions':368 '/en-us/azure/service-health/subscription-vs-tenant':426 '/microsoftdocs/mcp/blob/main/readme.md)':160 '3':131 'accept':199 'access':165,283,379,387,397,405,420,492 'activ':444 'admin':274,374 'advisori':271,337,401,412,495 'agent':80,124,183,197 'alert':30,296,433,446,478,528,538,548,559 'annot':216,350 'api':318,497 'apis/webhooks':28 'arg':520 'arm':436,482 'arm/bicep/powershell':298 'avail':150,229 'azur':2,8,38,48,242,266,290,304,332,388,399,408,453,464,493,503,514,525,535,545,556 'azure-service-health':1 'behavior':253 'bicep':448 'capabl':72 'categori':83,91,107,203,205 'caus':227 'code':20,59,312,488 'combin':62 'configur':17,29,56,284,285,289,395,416,427,441,475 'connector':323 'content':67,169 'cover':51 'data':471 'defin':430 'descript':207 'detail':238 'develop':11 'diagnos':35,217 'differ':255 'doc':175 'document':70,168 'e.g':95,111 'endpoint':498 'event':256,302 'expert':5,45 'extern':339 'fallback':187 'fetch':71,167,176,189 'file':101,109,116,121 'forward':534 'github.com':159 'github.com/microsoftdocs/mcp/blob/main/readme.md)':158 'graph':33,306,320,455,466,505 'guid':157 'guidanc':46 'heal':37 'health':4,10,26,40,50,215,219,244,268,292,295,301,334,349,364,378,390,410,423,432,443,459,470,477,509,516,527,537,547,558 'histori':391 'impact':517 'import':78,122 'includ':12 'index':84,204 'instal':154,156 'integr':19,24,58,311,331,487,524,544 'interpret':344 'issu':220 'kept':247 'knowledg':6 'kusto':309 'l120':98 'l33':210 'l33-l37':209 'l35':97 'l35-l120':96 'l37':211 'l38':236 'l38-l42':235 'l42':237 'l43':260 'l43-l51':259 'l51':261 'l52':287 'l52-l60':286 'l60':288 'l61':315 'l61-l70':314 'l70':316 'latest':139 'learn':182,196 'learn-agent-skil':181,195 'learn.microsoft.com':352,367,381,393,403,414,425,439,450,461,473,485,500,511,522,532,542,553,563 'learn.microsoft.com/en-us/azure/service-health/access-service-advisories-api':499 'learn.microsoft.com/en-us/azure/service-health/admin-access-reference':380 'learn.microsoft.com/en-us/azure/service-health/alerts-activity-log-service-notifications-arm':438 'learn.microsoft.com/en-us/azure/service-health/alerts-activity-log-service-notifications-bicep':449 'learn.microsoft.com/en-us/azure/service-health/azure-resource-graph-overview':460 'learn.microsoft.com/en-us/azure/service-health/health-history-overview':392 'learn.microsoft.com/en-us/azure/service-health/resource-graph-health-samples':510 'learn.microsoft.com/en-us/azure/service-health/resource-graph-impacted-samples':521 'learn.microsoft.com/en-us/azure/service-health/resource-graph-samples':472 'learn.microsoft.com/en-us/azure/service-health/resource-health-alert-powershell-template':484 'learn.microsoft.com/en-us/azure/service-health/resource-health-vm-annotation':351 'learn.microsoft.com/en-us/azure/service-health/security-advisories-add-subscription':402 'learn.microsoft.com/en-us/azure/service-health/security-advisories-elevated-access':413 'learn.microsoft.com/en-us/azure/service-health/service-health-alert-webhook-guide':531 'learn.microsoft.com/en-us/azure/service-health/service-health-alert-webhook-opsgenie':541 'learn.microsoft.com/en-us/azure/service-health/service-health-alert-webhook-pagerduty':552 'learn.microsoft.com/en-us/azure/service-health/service-health-alert-webhook-servicenow':562 'learn.microsoft.com/en-us/azure/service-health/service-health-notification-transitions':366 'learn.microsoft.com/en-us/azure/service-health/subscription-vs-tenant':424 'level':282 'lifecycl':249,359 'limit':14,53,233,354 'line':93,105,206 'link':110,119 'local':63 'locat':87 'log':445 'long':241 'manag':262 'markdown':186,202 'mcp':145,172 'metadata.generated':126 'microsoft':174 'microsoftdoc':146,173 'month':132 'network':164 'notif':245,365 'old':133 'opsgeni':324,540 'pagerduti':325,550 'pattern':21,60,313,489 'perform':231 'platform':223 'powershel':480 'prefer':170 'problem':232 'provid':44 'pull':137 'queri':31,178,192,300,310,328,467,506,513 'quick':65 'quick-refer':64 'quota':15,54,234,355 'rang':94 'rbac':276,384 'read':100,115 'refer':66,120 'relev':88 'remot':69 'repositori':143 'requir':163 'resourc':32,214,294,305,319,348,454,465,476,504,508,518 'retent':252,361 'return':185,201 'role':275,375,385 'rout':329 'rule':434 'run':502 'section':89 'secur':16,55,258,270,336,369,400,411,494 'security.md':112,113 'see':265 'send':555 'servic':3,9,25,39,49,243,267,291,333,363,377,389,409,422,431,442,458,469,515,526,536,546,557 'servicenow':326,561 'skill':41,43,77,162,184,198 'skill-azure-service-health' 'source-microsoftdocs' 'specifi':104 'stage':250 'string':179,193 'subscript':278,396,419 'suggest':134,151 'system':340 'tabl':307,456 'templat':437,483 'tenant':273,281,373,417 'tenant-level':280 'text/markdown':200 'tool':147 'topic':342,356,370,428,490 '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':13,52,208,222,341,346 'type':257 'understand':212,358,372,452 'url':343,357,371,429,491 'use':22,75,81,99,114,171,188,272,303,317,383,435,463 'user':136,153,226 'user-caus':225 'version':140 'via':27,297,496,529 'view':407 'vm':36,213,218,228,347 'vs':279,418 'webhook':321,530,551 'webpag':190","prices":[{"id":"f2762a07-af79-43ea-8dff-4efa8f8a7a53","listingId":"c3874dce-2788-4ba6-96ce-04583ff203f4","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-18T22:00:06.995Z"}],"sources":[{"listingId":"c3874dce-2788-4ba6-96ce-04583ff203f4","source":"github","sourceId":"MicrosoftDocs/Agent-Skills/azure-service-health","sourceUrl":"https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-service-health","isPrimary":false,"firstSeenAt":"2026-04-18T22:00:06.995Z","lastSeenAt":"2026-04-22T00:53:37.477Z"}],"details":{"listingId":"c3874dce-2788-4ba6-96ce-04583ff203f4","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"MicrosoftDocs","slug":"azure-service-health","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-19T02:43:40Z","description":"Curated Agent Skills for Microsoft & Azure – giving AI coding assistants structured, real-time expertise from Microsoft Learn docs.","skill_md_sha":"81616ec160d5b9b4e5f088a1c4e3b976a7d8ec61","skill_md_path":"skills/azure-service-health/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-service-health"},"layout":"multi","source":"github","category":"Agent-Skills","frontmatter":{"name":"azure-service-health","description":"Expert knowledge for Azure Service Health development including troubleshooting, limits & quotas, security, configuration, and integrations & coding patterns. Use when integrating Service Health via APIs/webhooks, configuring alerts, querying Resource Graph, or diagnosing VM health, and other Azure Service Health related development tasks. Not for Azure Monitor (use azure-monitor), Azure Reliability (use azure-reliability), Azure Resiliency (use azure-resiliency), Azure Quotas (use azure-quotas).","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-service-health"},"updatedAt":"2026-04-22T00:53:37.477Z"}}