Skip to main content
skill CX Codex

azure-service-health — Claude Code skill: what it does, how to install

This skill guides Azure Service Health work, from VM Resource Health and retirement alerts to APIs, Resource Graph queries, and webhooks.

CC-BY-4.0 183 installs ★ 818 updated 2026-11-02

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MicrosoftDocs/Agent-Skills --skill azure-service-health -a claude-code
Open on GitHub

What azure-service-health does

The skill provides reference guidance for Azure Service Health troubleshooting, quotas, access control, configuration, and integrations. It covers VM Resource Health, retirement alerts, Azure Resource Graph, APIs, and alert delivery to OpsGenie, PagerDuty, and ServiceNow.

A category index points the agent to line ranges and reference files. It can inspect local material with read_file, then fetch Microsoft documentation through mcp_microsoftdocs:microsoft_docs_fetch or the fetch_webpage fallback. Network access is required.

It also covers Service Health alerts with ARM, Bicep, and PowerShell, RBAC for history and security advisories, and queries that connect retirement events to affected resources. Its scope is Azure Service Health, not Azure Monitor, Azure Reliability, or Azure Resiliency.

What it helps with

  • diagnose a VM Resource Health issue
  • map a retirement alert to affected resources
  • define a Service Health alert with ARM or Bicep
  • check RBAC access to history and security advisories
  • route alerts to PagerDuty, OpsGenie, or ServiceNow

Example prompts for the agent

  • Diagnose this availability issue using VM Resource Health and explain what to check next.
  • Write an Azure Resource Graph query that finds resources affected by a retirement alert.
  • Show how to send Azure Service Health alerts to PagerDuty through a webhook.

How to install azure-service-health

1Skills CLI (Vercel)

npx skills add MicrosoftDocs/Agent-Skills --skill azure-service-health -a claude-code

2Manually: put the files in place

~/.claude/skills/azure-service-health/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/azure-service-health/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about azure-service-health

How do I install azure-service-health in Claude Code?

Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-service-health -a claude-code, then check ~/.claude/skills/azure-service-health/SKILL.md.

What does azure-service-health do?

It guides Azure Service Health work, including VM Resource Health diagnosis, retirement-alert analysis, Resource Graph queries, alert configuration, and webhook integrations.

What does azure-service-health require?

The skill needs network access. It retrieves documentation with mcp_microsoftdocs:microsoft_docs_fetch, or falls back to fetch_webpage.

Source text

SKILL.md · CC-BY-4.0
---
name: azure-service-health
description: Expert knowledge for Azure Service Health development including troubleshooting, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when handling Service Health APIs, Resource Graph queries, webhooks, VM Resource Health, or retirement alerts, 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).
compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata:
  generated_at: "2026-11-01"
  generator: "docs2skills/1.0.0"
---
# Azure Service Health Skill

This skill provides expert guidance for Azure Service Health. Covers troubleshooting, decision making, 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](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)

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 | L34-L38 | Understanding VM Resource Health annotations, diagnosing VM health issues, and troubleshooting platform or user-caused VM availability and performance problems |
| Decision Making | L39-L44 | Guidance on selecting and interpreting Azure retirement alerts, and mapping retirement notices to specific resources to assess impact and plan mitigation. |
| Limits & Quotas | L45-L49 | Details on how long Azure Service Health notifications are kept, their lifecycle stages, and retention behavior for different event types and channels |
| Security | L50-L58 | Managing who can see Azure Service Health and security advisories using tenant/subscription roles and RBAC, including configuring access scopes and viewing security-related notifications. |
| Configuration | L59-L66 | Configuring Service Health and Resource Health alerts via ARM/Bicep/PowerShell and querying Service Health data/fields with Azure Resource Graph. |
| Integrations & Coding Patterns | L67-L77 | Using APIs, Resource Graph, webhooks, and connectors (OpsGenie, PagerDuty, ServiceNow) to programmatically access, query, and route Azure Service Health and Security advisories |

### Troubleshooting
| Topic | URL |
|-------|-----|
| Interpret and troubleshoot VM Resource Health annotations | https://learn.microsoft.com/en-us/azure/service-health/resource-health-vm-annotation |

### Decision Making
| Topic | URL |
|-------|-----|
| Choose Azure retirement alert signals effectively | https://learn.microsoft.com/en-us/azure/service-health/service-retirement-alerting-guidance |
| Correlate retirement events to impacted Azure resources | https://learn.microsoft.com/en-us/azure/service-health/service-retirement-unified-impact-queries |

### Limits & Quotas
| Topic | URL |
|-------|-----|
| Understand lifecycle and retention of Service Health notifications | https://learn.microsoft.com/en-us/azure/service-health/service-health-notification-transitions |

### Security
| Topic | URL |
|-------|-----|
| Understand tenant admin roles for Service Health access | https://learn.microsoft.com/en-us/azure/service-health/admin-access-reference |
| Manage Azure Service Health history access with RBAC | https://learn.microsoft.com/en-us/azure/service-health/health-history-overview |
| Configure subscription access for Azure Security advisories | https://learn.microsoft.com/en-us/azure/service-health/security-advisories-add-subscription |
| Access and view Azure Service Health security advisories | https://learn.microsoft.com/en-us/azure/service-health/security-advisories-elevated-access |
| Configure tenant vs subscription access for Service Health | https://learn.microsoft.com/en-us/azure/service-health/subscription-vs-tenant |

### Configuration
| Topic | URL |
|-------|-----|
| Define Service Health alert rules using ARM templates | https://learn.microsoft.com/en-us/azure/service-health/alerts-activity-log-service-notifications-arm |
| Configure Service Health activity log alerts with Bicep | https://learn.microsoft.com/en-us/azure/service-health/alerts-activity-log-service-notifications-bicep |
| Understand Azure Resource Graph fields for Service Health | https://learn.microsoft.com/en-us/azure/service-health/azure-resource-graph-overview |
| Configure Resource Health alerts with PowerShell and ARM templates | https://learn.microsoft.com/en-us/azure/service-health/resource-health-alert-powershell-template |

### Integrations & Coding Patterns
| Topic | URL |
|-------|-----|
| Access Azure Security advisories via API endpoint | https://learn.microsoft.com/en-us/azure/service-health/access-service-advisories-api |
| Run Azure Resource Graph queries for Resource Health | https://learn.microsoft.com/en-us/azure/service-health/resource-graph-health-samples |
| Query Azure Service Health impacted resources with Resource Graph | https://learn.microsoft.com/en-us/azure/service-health/resource-graph-impacted-samples |
| Query Azure Service Health with Resource Graph | https://learn.microsoft.com/en-us/azure/service-health/resource-graph-samples |
| Integrate Azure Service Health alerts via webhooks | https://learn.microsoft.com/en-us/azure/service-health/service-health-alert-webhook-guide |
| Forward Azure Service Health alerts to OpsGenie | https://learn.microsoft.com/en-us/azure/service-health/service-health-alert-webhook-opsgenie |
| Integrate Azure Service Health alerts with PagerDuty webhooks | https://learn.microsoft.com/en-us/azure/service-health/service-health-alert-webhook-pagerduty |
| Send Azure Service Health alerts to ServiceNow | https://learn.microsoft.com/en-us/azure/service-health/service-health-alert-webhook-servicenow |

© MicrosoftDocs · CC-BY-4.0 · MicrosoftDocs/Agent-Skills

Similar skills

All skills for Cloud: AWS, Azure, GCP →

From the same set144

The whole set →
azure-sql-virtual-machines azure-sql-virtual-machines is a Claude Code skill for SQL Server architecture and troubleshooting on Azure Virtual Machines, including deployment, HA/DR, storage, backups, and security. CX Codex +1 185installs azure-arc This Claude Code skill helps with Azure Arc configuration, architecture, and troubleshooting. It retrieves Microsoft documentation to answer specific questions. CX Codex +1 185installs azure-automation Azure Automation skill for Claude Code and Codex guides cloud operations. Activates when building runbooks, configuring DSC, or fixing Hybrid Workers. CX Codex +1 184installs azure-nat-gateway Expert skill for Azure NAT Gateway: architecture, SNAT port optimization, flow logs, Azure Firewall integration. Covers outbound connectivity patterns, troubleshooting, and scaling for high-volume workloads. CX Codex +1 184installs azure-ddos-protection Skill with expert guidance on Azure DDoS Protection: configure policies, analyze attack logs, integrate network appliances and Azure Policy. Use it to set up IP and network-level DDoS defense for your Azure workloads. CX Codex +1 183installs azure-cloud-services Get help with Azure Cloud Services configuration, migration planning, troubleshooting, and PowerShell tasks. Use it for work involving Guest OS, Key Vault certificates, or .csdef and .cscfg files. CX Codex +1 182installs azure-local This skill for Claude Code and Codex supplies Azure Local guidance for setup, deployment, and troubleshooting. It covers SDN, Arc VMs, GPU workloads, and disconnected operations. CX Codex +1 182installs azure-bastion This skill delivers expert knowledge about Azure Bastion: architecture, security, configuration, and integration with private AKS clusters and VM scale sets. CX Codex +1 182installs

Project sponsors

Companies that keep this analytics open