{"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 as code, or diagnosing VM Resource Health event","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 and channels |\n| Security | L43-L51 | Managing access and permissions for Azure Service Health and security advisories, including tenant vs subscription scope, admin roles, and RBAC for viewing history and alerts |\n| Configuration | L52-L60 | Configuring Service Health and Resource Health alerts via ARM/Bicep/PowerShell and querying Service Health data/fields with Azure Resource Graph. |\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 fields 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.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 549 github stars · SKILL.md body (5,441 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-05-18T18:53:59.142Z","embedding":null,"createdAt":"2026-04-18T22:00:06.995Z","updatedAt":"2026-05-18T18:53:59.142Z","lastSeenAt":"2026-05-18T18:53:59.142Z","tsv":"'/en-us/azure/service-health/access-service-advisories-api':502 '/en-us/azure/service-health/admin-access-reference':383 '/en-us/azure/service-health/alerts-activity-log-service-notifications-arm':441 '/en-us/azure/service-health/alerts-activity-log-service-notifications-bicep':452 '/en-us/azure/service-health/azure-resource-graph-overview':463 '/en-us/azure/service-health/health-history-overview':395 '/en-us/azure/service-health/resource-graph-health-samples':513 '/en-us/azure/service-health/resource-graph-impacted-samples':524 '/en-us/azure/service-health/resource-graph-samples':475 '/en-us/azure/service-health/resource-health-alert-powershell-template':487 '/en-us/azure/service-health/resource-health-vm-annotation':354 '/en-us/azure/service-health/security-advisories-add-subscription':405 '/en-us/azure/service-health/security-advisories-elevated-access':416 '/en-us/azure/service-health/service-health-alert-webhook-guide':534 '/en-us/azure/service-health/service-health-alert-webhook-opsgenie':544 '/en-us/azure/service-health/service-health-alert-webhook-pagerduty':555 '/en-us/azure/service-health/service-health-alert-webhook-servicenow':565 '/en-us/azure/service-health/service-health-notification-transitions':369 '/en-us/azure/service-health/subscription-vs-tenant':427 '/microsoftdocs/mcp/blob/main/readme.md)':161 '3':132 'accept':200 'access':166,266,380,388,398,406,421,493 'activ':445 'admin':281,375 'advisori':275,338,402,413,496 'agent':81,125,184,198 'alert':30,289,300,434,447,479,529,539,549,560 'annot':217,351 'api':319,498 'apis/webhooks':28 'arg':521 'arm':437,483 'arm/bicep/powershell':302 'avail':151,230 'azur':2,8,39,49,243,270,309,333,389,400,409,454,465,494,504,515,526,536,546,557 'azure-service-health':1 'behavior':254 'bicep':449 'capabl':73 'categori':84,92,108,204,206 'caus':228 'channel':260 'code':20,32,60,313,489 'combin':63 'configur':17,29,57,290,294,396,417,428,442,476 'connector':324 'content':68,170 'cover':52 'data':472 'data/fields':307 'defin':431 'descript':208 'detail':239 'develop':11 'diagnos':34,218 'differ':256 'doc':176 'document':71,169 'e.g':96,112 'endpoint':499 'event':38,257 'expert':5,46 'extern':340 'fallback':188 'fetch':72,168,177,190 'field':457 'file':102,110,117,122 'forward':535 'github.com':160 'github.com/microsoftdocs/mcp/blob/main/readme.md)':159 'graph':311,321,456,467,506 'guid':158 'guidanc':47 'health':4,10,26,37,41,51,216,220,245,272,296,299,306,335,350,365,379,391,411,424,433,444,460,471,478,510,517,528,538,548,559 'histori':287,392 'impact':518 'import':79,123 'includ':12,276 'index':85,205 'instal':155,157 'integr':19,24,59,312,332,488,525,545 'interpret':345 'issu':221 'kept':248 'knowledg':6 'l120':99 'l33':211 'l33-l37':210 'l35':98 'l35-l120':97 'l37':212 'l38':237 'l38-l42':236 'l42':238 'l43':263 'l43-l51':262 'l51':264 'l52':292 'l52-l60':291 'l60':293 'l61':316 'l61-l70':315 'l70':317 'latest':140 'learn':183,197 'learn-agent-skil':182,196 'learn.microsoft.com':353,368,382,394,404,415,426,440,451,462,474,486,501,512,523,533,543,554,564 'learn.microsoft.com/en-us/azure/service-health/access-service-advisories-api':500 'learn.microsoft.com/en-us/azure/service-health/admin-access-reference':381 'learn.microsoft.com/en-us/azure/service-health/alerts-activity-log-service-notifications-arm':439 'learn.microsoft.com/en-us/azure/service-health/alerts-activity-log-service-notifications-bicep':450 'learn.microsoft.com/en-us/azure/service-health/azure-resource-graph-overview':461 'learn.microsoft.com/en-us/azure/service-health/health-history-overview':393 'learn.microsoft.com/en-us/azure/service-health/resource-graph-health-samples':511 'learn.microsoft.com/en-us/azure/service-health/resource-graph-impacted-samples':522 'learn.microsoft.com/en-us/azure/service-health/resource-graph-samples':473 'learn.microsoft.com/en-us/azure/service-health/resource-health-alert-powershell-template':485 'learn.microsoft.com/en-us/azure/service-health/resource-health-vm-annotation':352 'learn.microsoft.com/en-us/azure/service-health/security-advisories-add-subscription':403 'learn.microsoft.com/en-us/azure/service-health/security-advisories-elevated-access':414 'learn.microsoft.com/en-us/azure/service-health/service-health-alert-webhook-guide':532 'learn.microsoft.com/en-us/azure/service-health/service-health-alert-webhook-opsgenie':542 'learn.microsoft.com/en-us/azure/service-health/service-health-alert-webhook-pagerduty':553 'learn.microsoft.com/en-us/azure/service-health/service-health-alert-webhook-servicenow':563 'learn.microsoft.com/en-us/azure/service-health/service-health-notification-transitions':367 'learn.microsoft.com/en-us/azure/service-health/subscription-vs-tenant':425 'lifecycl':250,360 'limit':14,54,234,355 'line':94,106,207 'link':111,120 'local':64 'locat':88 'log':446 'long':242 'manag':265 'markdown':187,203 'mcp':146,173 'metadata.generated':127 'microsoft':175 'microsoftdoc':147,174 'month':133 'network':165 'notif':246,366 'old':134 'opsgeni':325,541 'pagerduti':326,551 'pattern':21,61,314,490 'perform':232 'permiss':268 'platform':224 'powershel':481 'prefer':171 'problem':233 'provid':45 'pull':138 'queri':179,193,304,329,468,507,514 'quick':66 'quick-refer':65 'quota':15,55,235,356 'rang':95 'rbac':284,385 'read':101,116 'refer':67,121 'relev':89 'remot':70 'repositori':144 'requir':164 'resourc':36,215,298,310,320,349,455,466,477,505,509,519 'retent':253,362 'return':186,202 'role':282,376,386 'rout':330 'rule':435 'run':503 'scope':280 'section':90 'secur':16,56,261,274,337,370,401,412,495 'security.md':113,114 'send':556 'servic':3,9,25,40,50,244,271,295,305,334,364,378,390,410,423,432,443,459,470,516,527,537,547,558 'servicenow':327,562 'skill':42,44,78,163,185,199 'skill-azure-service-health' 'source-microsoftdocs' 'specifi':105 'stage':251 'string':180,194 'subscript':279,397,420 'suggest':135,152 'system':341 'templat':438,484 'tenant':277,374,418 'text/markdown':201 'tool':148 'topic':343,357,371,429,491 '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,53,209,223,342,347 'type':258 'understand':213,359,373,453 'url':344,358,372,430,492 'use':22,76,82,100,115,172,189,318,384,436,464 'user':137,154,227 'user-caus':226 'version':141 'via':27,301,497,530 'view':286,408 'vm':35,214,219,229,348 'vs':278,419 'webhook':322,531,552 'webpag':191","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-05-18T18:53:59.142Z"}],"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":549,"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-05-17T02:50:05Z","description":"Curated Agent Skills for Microsoft & Azure – giving AI coding assistants structured, real-time expertise from Microsoft Learn docs.","skill_md_sha":"3c33922222feabc59eb2481b7fb81b92ca39e4f3","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 as code, or diagnosing VM Resource Health events, 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-05-18T18:53:59.142Z"}}