Agent skill

azure-service-health

Expert knowledge for Azure Service Health development including troubleshooting, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when integrating Service Health APIs/webhooks, configuring alerts via ARM/Bicep, querying events with Resource Graph, managing RBAC access, or diagnosing VM Resource Health issues, 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).

Stars 485
Forks 45

Install this agent skill to your Project

npx add-skill https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-service-health

Metadata

Additional technical details for this skill

generator
docs2skills/1.0.0
generated at
2026-04-05

SKILL.md

Azure Service Health Skill

This skill provides expert guidance for Azure Service Health. Covers troubleshooting, limits & quotas, security, configuration, integrations & coding patterns, and deployment. 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 L34-L38 Understanding VM Resource Health annotations, diagnosing VM health issues, and troubleshooting platform or user-caused VM availability and performance problems
Limits & Quotas L39-L43 Details on how long Azure Service Health notifications are kept, their lifecycle stages, and retention behavior for different event types
Security L44-L52 Managing access and roles for Azure Service Health, including tenant vs subscription RBAC, viewing security advisories, and configuring who can see health and security info.
Configuration L53-L61 Configuring Azure Service Health and Resource Health alerts via ARM/Bicep/PowerShell, and querying health events using Azure Resource Graph tables and Kusto queries
Integrations & Coding Patterns L62-L72 Using APIs, Resource Graph, webhooks, and connectors (OpsGenie, PagerDuty, ServiceNow) to query, route, and integrate Azure Service Health and Security advisories into external systems
Deployment L73-L76 Using Azure Policy to create, configure, and manage Service Health alert rules at scale across subscriptions and resource groups

Troubleshooting

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

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
Use Health history and RBAC for Azure Service Health 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 tables for Service Health https://learn.microsoft.com/en-us/azure/service-health/azure-resource-graph-overview
Use Azure Resource Graph queries for Service Health data https://learn.microsoft.com/en-us/azure/service-health/resource-graph-samples
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 ARG https://learn.microsoft.com/en-us/azure/service-health/resource-graph-impacted-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

Deployment

Topic URL
Deploy Service Health alert rules at scale using Azure Policy https://learn.microsoft.com/en-us/azure/service-health/service-health-alert-deploy-policy

Expand your agent's capabilities with these related and highly-rated skills.

MicrosoftDocs/Agent-Skills

azure-blueprints

Expert knowledge for Azure Blueprints development including troubleshooting, architecture & design patterns, security, configuration, and integrations & coding patterns. Use when defining Azure Blueprints, mapping built-in compliance sets, automating via CLI/PowerShell/REST, or fixing assignment errors, and other Azure Blueprints related development tasks. Not for Azure Policy (use azure-policy), Azure Resource Manager (use azure-resource-manager), Azure Managed Applications (use azure-managed-applications), Azure Deployment Environments (use azure-deployment-environments).

485 45
Explore
MicrosoftDocs/Agent-Skills

azure-hdinsight

Expert knowledge for Azure HDInsight development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when working with HDInsight Spark/Hive/Kafka/HBase clusters, Ambari, VNet networking, or Azure SQL/Cosmos DB integration, and other Azure HDInsight related development tasks. Not for Azure Synapse Analytics (use azure-synapse-analytics), Azure Databricks (use azure-databricks), Azure Stream Analytics (use azure-stream-analytics).

485 45
Explore
MicrosoftDocs/Agent-Skills

azure-advisor

Expert knowledge for Azure Advisor development including best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when configuring Advisor alerts, workbooks, RBAC access, bulk fixes, or Resource Graph/Kusto queries, and other Azure Advisor related development tasks. Not for Azure Cost Management (use azure-cost-management), Azure Monitor (use azure-monitor), Azure Policy (use azure-policy), Azure Service Health (use azure-service-health).

485 45
Explore
MicrosoftDocs/Agent-Skills

azure-cognitive-search

Expert knowledge for Azure AI Search development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when designing indexes/skillsets, vector/semantic search, indexers, RAG knowledge bases, or secure data access, and other Azure AI Search related development tasks. Not for Azure Cosmos DB (use azure-cosmos-db), Azure Data Explorer (use azure-data-explorer), Azure SQL Database (use azure-sql-database), Azure Synapse Analytics (use azure-synapse-analytics).

485 45
Explore
MicrosoftDocs/Agent-Skills

azure-migrate

Expert knowledge for Azure Migrate development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using AppCAT/CAST, Site Recovery REST APIs, Azure Migrate appliance, Arc-based discovery, or Resource Mover, and other Azure Migrate related development tasks. Not for Azure Database Migration service (use azure-database-migration), Azure Site Recovery (use azure-site-recovery), Azure Virtual Machines (use azure-virtual-machines), SQL Server on Azure Virtual Machines (use azure-sql-virtual-machines).

485 45
Explore
MicrosoftDocs/Agent-Skills

azure-maps

Expert knowledge for Azure Maps development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and integrations & coding patterns. Use when using Azure Maps web SDK, search/geocoding, routing/traffic, weather APIs, or migrating from Bing/Google Maps, and other Azure Maps related development tasks.

485 45
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results