About azure-event-grid
A reference skill for developers and operators working with Azure Event Grid, covering troubleshooting, design, security, configuration, and integrations. It combines a local quick-reference index with remote documentation retrieval.
Key features
- 01Troubleshooting and error diagnosis
- 02Architecture and design choices
- 03Quotas, limits, and delivery behavior
- 04Security and authentication configuration
- 05Service configuration and integration patterns
- 06Local index and remote documentation retrieval
Use cases
- 01Diagnose MQTT or webhook issues
- 02Plan event routing and MQTT patterns
- 03Configure access control and network security
- 04Review service limits and integration guidance
MCP support
It can retrieve Microsoft documentation with mcp_microsoftdocs:microsoft_docs_fetch, with fetch_webpage as a fallback.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-event-gridAfter installing, type/azure-event-gridin Claude Code to confirm it loaded.
Details
From the project READMEAzure Event Grid Skill
This skill provides expert guidance for Azure Event Grid. Covers troubleshooting, best practices, decision making, architecture & design patterns, 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), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools 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_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L36-L44 | Diagnosing and fixing Event Grid issues: MQTT broker problems, error codes, common failures, network connectivity, and webhook subscription validation errors. |
| Best Practices | L45-L49 | Guidance on designing client-side failover for Event Grid, including using multiple regions, retry logic, and resilient publishing patterns for high availability. |
| Decision Making | L50-L60 | Guidance for choosing Event Grid tiers, schemas, Kubernetes vs Azure hosting, MQTT routing, autoscale, push delivery, and migration from Event Grid on IoT Edge to IoT Edge hub. |
| Architecture & Design Patterns | L61-L67 | Patterns for routing events between namespaces, designing MQTT topic hierarchies, and implementing MQTT command/response flows using Azure Event Grid. |
| Limits & Quotas | L68-L79 | Event Grid delivery/retry behavior, custom headers, event retention, and region-specific quotas/limits for topics, namespaces, and Kubernetes-based Event Grid |
| Security | L80-L130 | Securing Event Grid: auth (keys, Entra ID, JWT, OAuth), RBAC, managed identities, MQTT auth, webhooks, IP firewalls, private endpoints, TLS, and Azure Policy compliance. |
| Configuration | L131-L204 | Configuring Event Grid and namespaces: topics, schemas, filters, dead-lettering, monitoring, MQTT broker/clients, TLS, autoscale/throughput, and integrating many Azure/Microsoft services. |
| Integrations & Coding Patterns | L205-L245 | Patterns and guides for integrating Event Grid with Auth0, Graph/M365 apps, MQTT, webhooks, Functions, Service Bus, Event Hubs, and understanding event schemas and handler configuration. |
Troubleshooting
| Topic | URL |
|---|---|
| Troubleshoot Azure Event Grid MQTT broker issues | https://learn.microsoft.com/en-us/azure/event-grid/mqtt-troubleshoot-errors |
| Azure Event Grid error codes and resolutions | https://learn.microsoft.com/en-us/azure/event-grid/troubleshoot-errors |
| Troubleshoot common Azure Event Grid issues | https://learn.microsoft.com/en-us/azure/event-grid/troubleshoot-issues |
| Diagnose Azure Event Grid network connectivity failures | https://learn.microsoft.com/en-us/azure/event-grid/troubleshoot-network-connectivity |
| Troubleshoot Event Grid webhook subscription validation | https://learn.microsoft.com/en-us/azure/event-grid/troubleshoot-subscription-validation |
Best Practices
| Topic | URL |
|---|---|
| Implement client-side failover for Azure Event Grid | https://learn.microsoft.com/en-us/azure/event-grid/custom-disaster-recovery-client-side |
Decision Making
| Topic | URL |
|---|---|
| Select the right Azure Event Grid tier | https://learn.microsoft.com/en-us/azure/event-grid/choose-right-tier |
| Choose compatible event schemas for Azure Event Grid subscriptions | https://learn.microsoft.com/en-us/azure/event-grid/event-schema-compatibility |
| Compare Event Grid on Kubernetes vs Azure features | https://learn.microsoft.com/en-us/azure/event-grid/kubernetes/features |
| Choose MQTT routing options in Event Grid | https://learn.microsoft.com/en-us/azure/event-grid/mqtt-routing |
| Use Autoscale for Azure Event Grid namespaces | https://learn.microsoft.com/en-us/azure/event-grid/namespace-autoscale-overview |
| Decide on push delivery for Event Grid namespaces | https://learn.microsoft.com/en-us/azure/event-grid/namespace-push-delivery-overview |
| Migrate from Event Grid on IoT Edge to IoT Edge hub | https://learn.microsoft.com/en-us/azure/event-grid/transition |
Architecture & Design Patterns
| Topic | URL |
|---|---|
| Forward events between Event Grid namespace topics | https://learn.microsoft.com/en-us/azure/event-grid/forward-events-to-another-namespace-topic |
| Implement MQTT request-response commands with Event Grid | https://learn.microsoft.com/en-us/azure/event-grid/mqtt-request-response-messages |
| Design MQTT topic spaces in Event Grid | https://learn.microsoft.com/en-us/azure/event-grid/mqtt-topic-spaces |