1---
2name: azure-event-hubs
3description: Expert knowledge for Azure Event Hubs development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using Kafka clients/Streams, .NET SDK, geo-replication, Entra ID/RBAC auth, or Blob checkpointing, and other Azure Event Hubs related development tasks. Not for Azure Service Bus (use azure-service-bus), Azure Event Grid (use azure-event-grid), Azure Notification Hubs (use azure-notification-hubs), Azure Web PubSub (use azure-web-pubsub).
4compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
5metadata:
6 generated_at: "2026-08-31"
7 generator: "docs2skills/1.0.0"
8---
9
10# Azure Event Hubs Skill
11
12This skill provides expert guidance for Azure Event Hubs. 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.
13
14## How to Use This Skill
15
16> **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
17
18> **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](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)
19
20This skill requires **network access** to fetch documentation content:
21- **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown.
22- **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown.
23
24## Category Index
25
26| Category | Lines | Description |
27|----------|-------|-------------|
28| Troubleshooting | L37-L49 | Diagnosing and fixing Event Hubs runtime issues: Kafka/AMQP errors, .NET/legacy exceptions, ARM failures, auth problems, connectivity, and Blob Storage checkpoint store errors. |
29| Best Practices | L50-L55 | Guidance on routing events between AMQP, Kafka, and HTTPS, and on designing/scaling Event Hubs with partitions and throughput units for performance and capacity. |
30| Decision Making | L56-L62 | Guidance on choosing Event Hubs tiers, auto-inflate settings, geo-replication modes, and planning migrations from Apache Kafka to Event Hubs. |
31| Architecture & Design Patterns | L63-L69 | Patterns and guidance for Event Hubs reliability: availability/consistency design, geo-disaster recovery, and building/operating replication tasks (often with Azure Functions). |
32| Limits & Quotas | L70-L79 | Event Hubs limits, quotas, and tier differences; max message sizes, capture intervals, platform behaviors, and governance via application groups. |
33| Security | L80-L108 | Securing Event Hubs: auth (Entra ID, SAS, RBAC, managed identities), encryption/CMK, confidential computing, TLS, and network access (NSP, VNet, firewall, Private Link, Azure Policy compliance). |
34| Configuration | L109-L121 | Configuring Event Hubs behavior: partitions, retention, geo-recovery, replication, log compaction, emulator setup, Avro capture schema, metrics/logs, and application group governance. |
35| Integrations & Coding Patterns | L122-L139 | Patterns and code for integrating Event Hubs with .NET, Kafka (clients, Streams, Connect, Debezium), Flink, Spark, Akka, schema/JSON registry, and adding metadata or managing hubs programmatically |
36| Deployment | L140-L145 | Guides for deploying Event Hubs with Kafka mirroring (MirrorMaker 1/2), setting up geo-replication, and running/local-testing Event Hubs apps using the emulator. |
37
38### Troubleshooting
39| Topic | URL |
40|-------|-----|
41| Resolve common Azure Event Hubs Kafka migration issues | https://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-frequently-asked-questions |
42| Troubleshoot Azure Event Hubs for Apache Kafka | https://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-troubleshooting-guide |
43| Troubleshoot AMQP errors in Azure Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-amqp-troubleshoot |
44| Handle legacy Azure Event Hubs messaging exceptions | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-messaging-exceptions |
45| Handle Azure Event Hubs .NET exceptions and recommended actions | https://learn.microsoft.com/en-us/azure/event-hubs/exceptions-dotnet |
46| Resolve Azure Resource Manager exceptions for Event Hubs operations | https://learn.microsoft.com/en-us/azure/event-hubs/resource-manager-exceptions |
47| Troubleshoot authentication and authorization failures in Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/troubleshoot-authentication-authorization |
48| Resolve Blob Storage checkpoint store issues for Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/troubleshoot-checkpoint-store-issues |
49| Diagnose and fix Azure Event Hubs connectivity issues | https://learn.microsoft.com/en-us/azure/event-hubs/troubleshooting-guide |
50
51### Best Practices
52| Topic | URL |
53|-------|-----|
54| Exchange Event Hubs events across AMQP, Kafka, and HTTPS | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-exchange-events-different-protocols |
55| Scale Azure Event Hubs with partitions and throughput units | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-scalability |
56
57### Decision Making
58| Topic | URL |
59|-------|-----|
60| Plan migration from Apache Kafka to Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-migration-guide |
61| Decide when and how to use Event Hubs Auto Inflate | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-auto-inflate |
62| Choose and manage Azure Event Hubs geo-replication modes | https://learn.microsoft.com/en-us/azure/event-hubs/geo-replication |
63
64### Architecture & Design Patterns
65| Topic | URL |
66|-------|-----|
67| Design for availability and consistency in Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-availability-and-consistency |
68| Apply Event Hubs event replication task patterns | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-federation-patterns |
69| Design Event Hubs replication tasks with Azure Functions | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-federation-replicator-functions |
70
71### Limits & Quotas
72| Topic | URL |
73|-------|-----|
74| Compare Event Hubs tier features and quotas | https://learn.microsoft.com/en-us/azure/event-hubs/compare-tiers |
75| Configure Event Hubs Capture intervals and limits | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-capture-overview |
76| Azure Event Hubs platform limits and behavioral details | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-faq |
77| Send and receive large Event Hubs messages | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-quickstart-stream-large-messages |
78| Review Azure Event Hubs quotas and limits | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-quotas |
79| Govern Event Hubs resources with application groups | https://learn.microsoft.com/en-us/azure/event-hubs/resource-governance-overview |
80
81### Security
82| Topic | URL |
83|-------|-----|
84| Associate network security perimeters with Event Hubs namespaces | https://learn.microsoft.com/en-us/azure/event-hubs/associate-network-security-perimeter |
85| Authenticate applications with Entra ID for Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/authenticate-application |
86| Use managed identities to authenticate to Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/authenticate-managed-identity |
87| Authenticate to Event Hubs from VMs with managed identity | https://learn.microsoft.com/en-us/azure/event-hubs/authenticate-managed-identity-virtual-machine |
88| Implement SAS authentication for Azure Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/authenticate-shared-access-signature |
89| Authorize Event Hubs access using Entra ID and RBAC | https://learn.microsoft.com/en-us/azure/event-hubs/authorize-access-azure-active-directory |
90| Choose and configure Event Hubs authorization options | https://learn.microsoft.com/en-us/azure/event-hubs/authorize-access-event-hubs |
91| Configure SAS authorization for Azure Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/authorize-access-shared-access-signature |
92| Enable confidential computing for Azure Event Hubs Dedicated | https://learn.microsoft.com/en-us/azure/event-hubs/confidential-computing |
93| Configure customer-managed keys for Event Hubs encryption | https://learn.microsoft.com/en-us/azure/event-hubs/configure-customer-managed-key |
94| Enable and configure managed identities for Event Hubs namespaces | https://learn.microsoft.com/en-us/azure/event-hubs/enable-managed-identity |
95| Configure managed identity for Event Hubs Capture | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-capture-managed-identity |
96| Retrieve and understand Event Hubs connection strings | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-get-connection-string |
97| Configure IP firewall rules for Azure Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-ip-filtering |
98| Secure Event Hubs with virtual network service endpoints | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-service-endpoints |
99| Configure network security for Azure Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/network-security |
100| Secure Event Hubs with Network Security Perimeter | https://learn.microsoft.com/en-us/azure/event-hubs/network-security-perimeter |
101| Migrate Event Hubs apps to passwordless authentication with Entra ID | https://learn.microsoft.com/en-us/azure/event-hubs/passwordless-migration-event-hubs |
102| Use built-in Azure Policy definitions for Event Hubs governance | https://learn.microsoft.com/en-us/azure/event-hubs/policy-reference |
103| Restrict Event Hubs access using Private Link endpoints | https://learn.microsoft.com/en-us/azure/event-hubs/private-link-service |
104| Apply regulatory compliance policies to Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/security-controls-policy |
105| Audit Event Hubs TLS compliance using Azure Policy | https://learn.microsoft.com/en-us/azure/event-hubs/transport-layer-security-audit-minimum-version |
106| Configure Event Hubs client applications to use specific TLS versions | https://learn.microsoft.com/en-us/azure/event-hubs/transport-layer-security-configure-client-version |
107| Set minimum TLS version for Azure Event Hubs namespaces | https://learn.microsoft.com/en-us/azure/event-hubs/transport-layer-security-configure-minimum-version |
108| Enforce minimum TLS version for Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/transport-layer-security-enforce-minimum-version |
109
110### Configuration
111| Topic | URL |
112|-------|-----|
113| Configure partitioning, retention, and cleanup for Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/configure-event-hub-properties |
114| Configure geo-disaster recovery pairing for Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/configure-geo-disaster-recovery |
115| Dynamically increase partitions in an Event Hub | https://learn.microsoft.com/en-us/azure/event-hubs/dynamically-add-partitions |
116| Configure code-free Event Hubs replication tasks | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-federation-configuration |
117| Understand and use Event Hubs captured Avro schema | https://learn.microsoft.com/en-us/azure/event-hubs/explore-captured-avro-files |
118| Reference monitoring metrics and logs for Azure Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/monitor-event-hubs-reference |
119| Configure Event Hubs application groups for resource governance | https://learn.microsoft.com/en-us/azure/event-hubs/resource-governance-with-app-groups |
120| Configure and run the Azure Event Hubs emulator locally | https://learn.microsoft.com/en-us/azure/event-hubs/test-locally-with-event-hub-emulator |
121| Configure and use log compaction in Azure Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/use-log-compaction |
122
123### Integrations & Coding Patterns
124| Topic | URL |
125|-------|-----|
126| Add custom metadata to Event Hubs events | https://learn.microsoft.com/en-us/azure/event-hubs/add-custom-data-event |
127| Configure Apache Kafka clients for Azure Event Hubs compatibility | https://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-configurations |
128| Use Kafka Streams with Azure Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-streams |
129| Use Kafka transactions with Azure Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-transactions |
130| Connect .NET applications to Azure Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/connect-event-hub |
131| Connect Akka Streams to Azure Event Hubs via Kafka | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-akka-streams-tutorial |
132| Use Debezium CDC with Kafka Connect on Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-connect-debezium |
133| Integrate Kafka Connect with Azure Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-connect-tutorial |
134| Connect Apache Flink to Azure Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-flink-tutorial |
135| Connect Apache Spark streaming apps to Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-spark-tutorial |
136| Use .NET management libraries to provision Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-management-libraries |
137| Implement client-side schema enforcement for Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/schema-registry-client-side-enforcement |
138| Use JSON Schema registry with Kafka clients on Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/schema-registry-json-schema-kafka |
139| Choose and use client SDKs for Azure Event Hubs | https://learn.microsoft.com/en-us/azure/event-hubs/sdks |
140
141### Deployment
142| Topic | URL |
143|-------|-----|
144| Mirror Kafka brokers to Event Hubs with MirrorMaker 1 | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-mirror-maker-tutorial |
145| Replicate Kafka clusters to Event Hubs with MirrorMaker 2 | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-mirrormaker-2-tutorial |
146| Configure and operate Event Hubs geo-replication | https://learn.microsoft.com/en-us/azure/event-hubs/use-geo-replication |
microsoftdocs