SkillRepo
Sign InSign Up
Catalog
MicrosoftDocs/azure-service-health

MicrosoftDocs

azure-service-health

Expert knowledge for Azure Service Health development including troubleshooting, limits & quotas, security, configuration, and integrations & coding patterns. Use when routing Service Health alerts via APIs/webhooks, configuring ARM/Bicep alerts, or diagnosing VM Resource 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).

v1.0Latest
New~1.5kUpdated Jun 26, 2026

Azure Service Health Skill

This 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.

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 L33-L37 Understanding VM Resource Health annotations, diagnosing VM health issues, and troubleshooting platform or user-caused VM availability and performance problems
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
Security L43-L51 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 L52-L59 Configuring Service Health and Resource Health alerts via ARM/Bicep/PowerShell and querying Service Health data/fields with Azure Resource Graph.
Integrations & Coding Patterns L60-L70 Using APIs, Resource Graph, webhooks, and connectors to query Azure Service Health/Security data and route alerts into tools like OpsGenie, PagerDuty, and ServiceNow

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
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 ARG 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
Files1
1 files · 18.2 KB

Select a file to preview

Overall Score

76/100

Grade

B

Good

Safety

88

Quality

72

Clarity

82

Completeness

65

Summary

An Azure Service Health reference skill that provides expert guidance on troubleshooting, configuration, security, and API integration patterns. The skill acts as a knowledge navigator, directing agents to fetch detailed documentation from Microsoft Learn via network calls and linking to structured reference content for topics like alerts, Resource Health, webhooks, and RBAC configuration.

Detected Capabilities

network-accessdocumentation-fetchingdata-queryingreference-linking

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

service health alertsresource health troubleshootingazure service health configwebhook alert integrationservice health rbac

Risk Signals

INFO

Network access required for documentation fetching (mcp_microsoftdocs and fetch_webpage)

Compatibility section, 'How to Use' section
INFO

Skill references external Microsoft Learn URLs but does not execute or download code

Category sections (Troubleshooting, Limits, Security, Configuration, Integrations)
INFO

No shell execution, file writes, or destructive operations

Entire skill content

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.comlearn.microsoft.com

Use Cases

  • Diagnose and troubleshoot VM Resource Health issues, including platform-caused and user-caused availability problems
  • Configure Service Health and Resource Health alerts using ARM, Bicep, or PowerShell templates
  • Manage RBAC and access control for Azure Service Health notifications and security advisories
  • Route Service Health alerts to incident management tools (OpsGenie, PagerDuty, ServiceNow) via webhooks
  • Query Azure Resource Graph for Service Health data and impacted resources
  • Access and integrate Azure Security advisories via API endpoints

Quality Notes

  • Well-organized category index with clear line ranges and file linking patterns
  • Clear prerequisites documented: network access required, MCP tools availability checked with fallback
  • Strength: Practical use cases (OpsGenie, PagerDuty, ServiceNow integration)
  • Strength: Explicit scope boundaries—excludes Azure Monitor, Reliability, Resiliency, Quotas (redirects to other skills)
  • Strength: Metadata refresh guidance (3-month staleness check)
  • Minor weakness: Content is purely navigational; actual guidance content not included inline (references external URLs only)
  • Minor weakness: No example queries or ARM/Bicep template snippets provided inline—relies entirely on external documentation
  • Fallback mechanism provides good resilience if primary tool unavailable
Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Use MicrosoftDocs/azure-service-health in your dev environment

Start a Developer trial

Command Palette

Search for a command to run...