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, and integrations & coding patterns. Use when configuring Event Grid topics/subscriptions, MQTT broker clients, Azure event schemas, webhooks, or Service Bus/Event Hubs integrations, 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-07-26","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, 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	L36-L44	Diagnosing and fixing Event Grid issues: MQTT broker problems, error codes, common failures, network connectivity, and event 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-L58	Guidance on choosing Event Grid tiers and schemas, comparing Azure vs Kubernetes deployments, configuring autoscale, and migrating from IoT Edge-based Event Grid setups.
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-L76	Event Grid delivery/retry behavior, custom headers, event retention, and region-specific quotas/limits for topics, namespaces, and Kubernetes-based Event Grid
Security	L77-L128	Securing Event Grid: authentication (keys, Entra ID, JWT, OAuth), RBAC, managed identities, MQTT/webhook auth, TLS, IP/firewalls, private endpoints, and security policies/compliance.
Configuration	L129-L203	Configuring Event Grid and namespaces: topics, subscriptions, filters, dead-lettering, monitoring, MQTT broker/clients, and detailed event schemas for Azure/ACS/AKS/Graph/IoT and other sources.
Integrations & Coding Patterns	L204-L246	Patterns and tutorials for wiring Event Grid to external services (Auth0, M365, Graph, ACS, Key Vault, MQTT, Service Bus, Event Hubs, webhooks) and using event schemas, publishers, and handlers.

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
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
Use Autoscale for Azure Event Grid namespaces	https://learn.microsoft.com/en-us/azure/event-grid/namespace-autoscale-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

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
Azure Event Grid FAQs on limits and behavior	https://learn.microsoft.com/en-us/azure/event-grid/faq
Understand Event Grid on Kubernetes delivery and retry behavior	https://learn.microsoft.com/en-us/azure/event-grid/kubernetes/delivery-retry
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
Review Azure Event Grid quotas and 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-based 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