Skip to content
LiveNew tools this week
Submit
AIMarketly
azure-event-hubs logo

azure-event-hubs

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, Flink/Spark, geo-...

MicrosoftDocs/Agent-Skills0installs772stars

SKILL.md

Full skill instructions

Azure Event Hubs Skill

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

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

CategoryLinesDescription
TroubleshootingL37-L49Diagnosing and fixing Event Hubs runtime issues: Kafka/​AMQP errors, .NET/​legacy exceptions, ARM failures, auth problems, connectivity, and Blob Storage checkpoint store errors.
Best PracticesL50-L55Guidance on routing events between AMQP, Kafka, and HTTPS, and on designing/​scaling Event Hubs with partitions and throughput units for performance and capacity.
Decision MakingL56-L62Guidance on migrating from Kafka, selecting the right Event Hubs tier, and deciding when/​how to use Auto Inflate for scaling and cost optimization
Architecture & Design PatternsL63-L69Patterns and guidance for Event Hubs reliability: availability/​consistency design, geo-disaster recovery, and building/​operating replication tasks (often with Azure Functions).
Limits & QuotasL70-L76Event Hubs capacity, throughput, and entity limits; quota rules and enforcement; and using application groups to govern and throttle client access and usage.
SecurityL77-L104Securing Event Hubs: auth (Entra ID, SAS, RBAC, managed identity), encryption and CMKs, network isolation (VNet, NSG, Private Link, NSP), TLS settings, and compliance/​governance via Azure Policy.
ConfigurationL105-L118Configuring Event Hubs behavior: partitions, retention, geo-DR, replication, processing units, metrics/​logs, app groups, log compaction, and Avro capture schema.
Integrations & Coding PatternsL119-L136Patterns 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
DeploymentL137-L143Guides for deploying Event Hubs with Kafka mirroring (MirrorMaker 1/​2), setting up geo-replication, and running/​local-testing Event Hubs apps using the emulator.

Troubleshooting

TopicURL
Resolve common Azure Event Hubs Kafka migration issueshttps://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-frequently-asked-questions
Troubleshoot Azure Event Hubs for Apache Kafkahttps://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-troubleshooting-guide
Troubleshoot AMQP errors in Azure Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-amqp-troubleshoot
Handle legacy Azure Event Hubs messaging exceptionshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-messaging-exceptions
Handle Azure Event Hubs .NET exceptions and recommended actionshttps://learn.microsoft.com/en-us/azure/event-hubs/exceptions-dotnet
Resolve Azure Resource Manager exceptions for Event Hubs operationshttps://learn.microsoft.com/en-us/azure/event-hubs/resource-manager-exceptions
Troubleshoot authentication and authorization failures in Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/troubleshoot-authentication-authorization
Resolve Blob Storage checkpoint store issues for Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/troubleshoot-checkpoint-store-issues
Diagnose and fix Azure Event Hubs connectivity issueshttps://learn.microsoft.com/en-us/azure/event-hubs/troubleshooting-guide

Best Practices

TopicURL
Exchange Event Hubs events across AMQP, Kafka, and HTTPShttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-exchange-events-different-protocols
Scale Azure Event Hubs with partitions and throughput unitshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-scalability

Decision Making

TopicURL
Plan migration from Apache Kafka to Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-migration-guide
Choose the right Azure Event Hubs tierhttps://learn.microsoft.com/en-us/azure/event-hubs/compare-tiers
Decide when and how to use Event Hubs Auto Inflatehttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-auto-inflate

Architecture & Design Patterns

TopicURL
Design for availability and consistency in Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-availability-and-consistency
Apply Event Hubs event replication task patternshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-federation-patterns
Design Event Hubs replication tasks with Azure Functionshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-federation-replicator-functions

Limits & Quotas

TopicURL
Azure Event Hubs platform limits and behavioral detailshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-faq
Review Azure Event Hubs quotas and limitshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-quotas
Govern Event Hubs resources with application groupshttps://learn.microsoft.com/en-us/azure/event-hubs/resource-governance-overview

Security

TopicURL
Associate network security perimeters with Event Hubs namespaceshttps://learn.microsoft.com/en-us/azure/event-hubs/associate-network-security-perimeter
Authenticate applications with Entra ID for Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/authenticate-application
Authenticate to Event Hubs using managed identitieshttps://learn.microsoft.com/en-us/azure/event-hubs/authenticate-managed-identity
Authenticate to Event Hubs using SAS tokenshttps://learn.microsoft.com/en-us/azure/event-hubs/authenticate-shared-access-signature
Authorize Event Hubs access using Entra RBAC roleshttps://learn.microsoft.com/en-us/azure/event-hubs/authorize-access-azure-active-directory
Choose authorization options for Azure Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/authorize-access-event-hubs
Configure SAS authorization for Azure Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/authorize-access-shared-access-signature
Enable confidential computing for Azure Event Hubs Dedicatedhttps://learn.microsoft.com/en-us/azure/event-hubs/confidential-computing
Configure customer-managed keys for Azure Event Hubs encryptionhttps://learn.microsoft.com/en-us/azure/event-hubs/configure-customer-managed-key
Enable and configure managed identities for Event Hubs namespaceshttps://learn.microsoft.com/en-us/azure/event-hubs/enable-managed-identity
Configure managed identity for Event Hubs Capturehttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-capture-managed-identity
Obtain secure connection strings for Azure Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-get-connection-string
Configure IP firewall rules for Azure Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-ip-filtering
Secure Event Hubs with virtual network service endpointshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-service-endpoints
Configure network security for Azure Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/network-security
Secure Event Hubs with Network Security Perimeterhttps://learn.microsoft.com/en-us/azure/event-hubs/network-security-perimeter
Migrate Event Hubs apps to passwordless authentication with Entra IDhttps://learn.microsoft.com/en-us/azure/event-hubs/passwordless-migration-event-hubs
Use built-in Azure Policy definitions for Event Hubs governancehttps://learn.microsoft.com/en-us/azure/event-hubs/policy-reference
Restrict Event Hubs access using Private Link endpointshttps://learn.microsoft.com/en-us/azure/event-hubs/private-link-service
Apply regulatory compliance policies to Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/security-controls-policy
Audit Event Hubs TLS compliance using Azure Policyhttps://learn.microsoft.com/en-us/azure/event-hubs/transport-layer-security-audit-minimum-version
Configure Event Hubs client applications to use specific TLS versionshttps://learn.microsoft.com/en-us/azure/event-hubs/transport-layer-security-configure-client-version
Set minimum TLS version for Azure Event Hubs namespaceshttps://learn.microsoft.com/en-us/azure/event-hubs/transport-layer-security-configure-minimum-version
Enforce minimum TLS version for Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/transport-layer-security-enforce-minimum-version

Configuration

TopicURL
Configure partitioning, retention, and cleanup for Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/configure-event-hub-properties
Configure geo-disaster recovery pairing for Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/configure-geo-disaster-recovery
Configure processing units for Event Hubs Premiumhttps://learn.microsoft.com/en-us/azure/event-hubs/configure-processing-units-premium-namespace
Dynamically increase partitions in an Event Hubhttps://learn.microsoft.com/en-us/azure/event-hubs/dynamically-add-partitions
Configure code-free Event Hubs replication taskshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-federation-configuration
Understand and use Event Hubs captured Avro schemahttps://learn.microsoft.com/en-us/azure/event-hubs/explore-captured-avro-files
Configure Azure Monitor metrics and alerts for Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/monitor-event-hubs
Reference for Event Hubs metrics, logs, and diagnostic settingshttps://learn.microsoft.com/en-us/azure/event-hubs/monitor-event-hubs-reference
Configure Event Hubs application groups for resource governancehttps://learn.microsoft.com/en-us/azure/event-hubs/resource-governance-with-app-groups
Configure and use log compaction in Azure Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/use-log-compaction

Integrations & Coding Patterns

TopicURL
Add custom metadata to Event Hubs eventshttps://learn.microsoft.com/en-us/azure/event-hubs/add-custom-data-event
Configure Apache Kafka clients for Azure Event Hubs compatibilityhttps://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-configurations
Use Kafka Streams with Azure Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-streams
Use Kafka transactions with Azure Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-transactions
Connect .NET applications to Azure Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/connect-event-hub
Connect Akka Streams to Azure Event Hubs via Kafkahttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-akka-streams-tutorial
Use Debezium CDC with Kafka Connect on Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-connect-debezium
Integrate Kafka Connect with Azure Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-connect-tutorial
Connect Apache Flink to Azure Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-flink-tutorial
Connect Apache Spark streaming apps to Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-spark-tutorial
Use .NET management libraries to provision Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-management-libraries
Implement client-side schema enforcement for Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/schema-registry-client-side-enforcement
Use JSON Schema registry with Kafka clients on Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/schema-registry-json-schema-kafka
Choose and use client SDKs for Azure Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/sdks

Deployment

TopicURL
Mirror Kafka brokers to Event Hubs with MirrorMaker 1https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-mirror-maker-tutorial
Replicate Kafka clusters to Event Hubs with MirrorMaker 2https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-mirrormaker-2-tutorial
Test Event Hubs applications locally with the emulatorhttps://learn.microsoft.com/en-us/azure/event-hubs/test-locally-with-event-hub-emulator
Configure and operate Event Hubs geo-replicationhttps://learn.microsoft.com/en-us/azure/event-hubs/use-geo-replication