azure-event-grid

name	azure-event-grid
description	Expert knowledge for Azure Event Grid development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when securing Event Grid endpoints, configuring topics/subscriptions, using MQTT, routing Azure events, or deploying on Arc Kubernetes, and other Azure Event Grid related development tasks. Not for Azure Service Bus (use azure-service-bus), Azure Event Hubs (use azure-event-hubs), Azure Notification Hubs (use azure-notification-hubs), Azure Logic Apps (use azure-logic-apps).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-04-12","generator":"docs2skills/1.0.0"}

Azure 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, 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	L37-L45	Diagnosing and fixing Event Grid issues: MQTT broker problems, error codes, common failures, network connectivity, and event subscription validation errors.
Best Practices	L46-L50	Guidance on designing client-side failover for Event Grid, including using multiple regions, retry logic, and resilient publishing patterns for high availability.
Decision Making	L51-L58	Guidance on choosing Event Grid tiers, matching event schemas, comparing Azure vs Kubernetes Event Grid, and migrating from Event Grid on IoT Edge to IoT Edge hub.
Architecture & Design Patterns	L59-L64	Patterns for routing events across Event Grid namespace topics and implementing MQTT-based request/response command workflows using Event Grid.
Limits & Quotas	L65-L75	Event Grid delivery/retry behavior, custom headers, event retention, MQTT protocol support, and regional quotas/service limits for topics, namespaces, and brokers
Security	L76-L127	Securing Event Grid: auth (keys, SAS, Entra ID, JWT, OAuth), RBAC, managed identities, webhooks/MQTT, TLS, IP firewalls, private endpoints, network perimeters, and Azure Policy controls.
Configuration	L128-L205	Configuring Event Grid and MQTT: topics, subscriptions, filters, routing, dead-lettering, monitoring/metrics, and detailed event schemas for many Azure and Microsoft services.
Integrations & Coding Patterns	L206-L247	Patterns for publishing, routing, and consuming Event Grid events with HTTP/webhooks, MQTT, Azure/M365/SaaS sources, and handlers like Event Hubs, Monitor, Relay, and custom endpoints.
Deployment	L248-L251	Guides for deploying Event Grid on Azure Arc-enabled Kubernetes, including installing and configuring the Event Grid extension on Arc clusters.

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
Fix Azure Event Grid subscription validation errors	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
Choose the correct 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 Event Grid features	https://learn.microsoft.com/en-us/azure/event-grid/kubernetes/features
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

Limits & Quotas

Topic	URL
Understand Azure Event Grid delivery and retry behavior	https://learn.microsoft.com/en-us/azure/event-grid/delivery-and-retry
Configure custom delivery headers for Azure Event Grid events	https://learn.microsoft.com/en-us/azure/event-grid/delivery-properties
Understand event retention for Event Grid namespace topics	https://learn.microsoft.com/en-us/azure/event-grid/event-retention
MQTT feature and protocol support in Event Grid broker	https://learn.microsoft.com/en-us/azure/event-grid/mqtt-support
Set custom delivery headers for Event Grid namespaces	https://learn.microsoft.com/en-us/azure/event-grid/namespace-delivery-properties
Delivery and retry behavior for Event Grid namespace push	https://learn.microsoft.com/en-us/azure/event-grid/namespace-delivery-retry
Azure Event Grid quotas and service limits by region	https://learn.microsoft.com/en-us/azure/event-grid/quotas-limits

Security

Topic	URL
Assign Event Grid managed identities to Azure roles on destinations	https://learn.microsoft.com/en-us/azure/event-grid/add-identity-roles
Use access keys and SAS to authenticate Event Grid clients	https://learn.microsoft.com/en-us/azure/event-grid/authenticate-with-access-keys-shared-access-signatures
Authenticate Event Grid namespace publishers with Entra ID	https://learn.microsoft.com/en-us/azure/event-grid/authenticate-with-entra-id-namespaces
Configure Microsoft Entra ID auth for Event Grid publishing	https://learn.microsoft.com/en-us/azure/event-grid/authenticate-with-microsoft-entra-id
Configure JWT authentication for Event Grid namespaces	https://learn.microsoft.com/en-us/azure/event-grid/authenticate-with-namespaces-using-json-web-tokens
Configure webhook authentication for Event Grid namespaces	https://learn.microsoft.com/en-us/azure/event-grid/authenticate-with-namespaces-using-webhook-authentication
Authenticate Event Grid publishers to topics and domains	https://learn.microsoft.com/en-us/azure/event-grid/authentication-overview
Configure access, identity, and data residency for Event Grid topics	https://learn.microsoft.com/en-us/azure/event-grid/configure-custom-topic
Configure IP firewall rules for Event Grid topics and domains	https://learn.microsoft.com/en-us/azure/event-grid/configure-firewall
Configure IP firewall rules for Event Grid namespaces	https://learn.microsoft.com/en-us/azure/event-grid/configure-firewall-namespaces

Configuration

Topic	URL
Configure custom domains for Event Grid MQTT and HTTP	https://learn.microsoft.com/en-us/azure/event-grid/assign-custom-domain-name
Azure Communication Services chat events schema for Event Grid	https://learn.microsoft.com/en-us/azure/event-grid/communication-services-chat-events
Presence events schema for Azure Communication Services	https://learn.microsoft.com/en-us/azure/event-grid/communication-services-presence-events
Job Router events schema for Azure Communication Services	https://learn.microsoft.com/en-us/azure/event-grid/communication-services-router-events
Azure Communication Services SMS events schema for Event Grid	https://learn.microsoft.com/en-us/azure/event-grid/communication-services-telephony-sms-events
Voice and video calling events schema for Event Grid	https://learn.microsoft.com/en-us/azure/event-grid/communication-services-voice-video-events
Create and manage Event Grid namespace event subscriptions	https://learn.microsoft.com/en-us/azure/event-grid/create-view-manage-event-subscriptions
Create and manage Event Grid namespace topics	https://learn.microsoft.com/en-us/azure/event-grid/create-view-manage-namespace-topics
Configure dead-lettering for Event Grid namespace subscriptions	https://learn.microsoft.com/en-us/azure/event-grid/dead-letter-event-subscriptions-namespace-topics
Enable diagnostic logs for Azure Event Grid resources	https://learn.microsoft.com/en-us/azure/event-grid/enable-diagnostic-logs-topic

Integrations & Coding Patterns

Topic	URL
Connect Auth0 to Azure via Event Grid partner topics	https://learn.microsoft.com/en-us/azure/event-grid/auth0-how-to
Send Auth0 events to Application Insights via Event Grid	https://learn.microsoft.com/en-us/azure/event-grid/auth0-log-stream-app-insights
Stream Auth0 logs to Blob Storage using Event Grid	https://learn.microsoft.com/en-us/azure/event-grid/auth0-log-stream-blob-storage
Use CloudEvents v1.0 schema with Azure Event Grid	https://learn.microsoft.com/en-us/azure/event-grid/cloud-event-schema
Use Microsoft Cloud Printing events with Event Grid	https://learn.microsoft.com/en-us/azure/event-grid/cloud-printing-events
Use ACS Advanced Messaging events with Event Grid	https://learn.microsoft.com/en-us/azure/event-grid/communication-services-advanced-messaging-events
Use Azure Communication Services email events with Event Grid	https://learn.microsoft.com/en-us/azure/event-grid/communication-services-email-events
Use Microsoft 365 Group Conversation events with Event Grid	https://learn.microsoft.com/en-us/azure/event-grid/conversation-events
Understand Azure Event Grid proprietary event schema	https://learn.microsoft.com/en-us/azure/event-grid/event-schema
Use Azure API Center as an Event Grid source	https://learn.microsoft.com/en-us/azure/event-grid/event-schema-api-center
Use API Management as an Event Grid source	https://learn.microsoft.com/en-us/azure/event-grid/event-schema-api-management

Deployment

Topic	URL
Install Event Grid extension on Azure Arc-enabled Kubernetes	https://learn.microsoft.com/en-us/azure/event-grid/kubernetes/install-k8s-extension