Skill

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-disaster recovery, or Premium processing units, 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 Stream Analytics (use azure-stream-analytics).

npx claudepluginhub atc-net/atc-agentic-toolkit --plugin azure

Tool Access

This skill uses the workspace's default tool permissions.

Preview

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.

SKILL.md

Similar Skills

azure-eventhub-py

37.1k

Sends and receives high-throughput events via Azure Event Hubs Python SDK. Supports producers, consumers, batching, partitioning, and blob checkpointing for streaming pipelines.

antigravity-awesome-skills

azure-messaging

902

Troubleshoots Azure Event Hubs and Service Bus SDK issues across Python, Java, JavaScript, and .NET. Handles connection failures, authentication errors, message locks, processing problems, and configuration.

azure

azure-eventhub-py

2.0k

Implements Azure Event Hubs producers, consumers, and checkpointing in Python for high-throughput event streaming and ingestion.

azure-sdk-python

Stats

Parent Repo Stars1

Parent Repo Forks1

Last CommitApr 3, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Azure Event Hubs Skill

How to Use This Skill

IMPORTANT for Agent: This file may be large. Use the Category Index below to locate relevant sections, then use read_file with specific line ranges (e.g., L136-L144) to read the sections needed for the user's question This skill requires network access to fetch documentation content. Use mcp_microsoftdocs:microsoft_docs_fetch to retrieve full articles.

Fallback: Use the built-in WebFetch tool if the Microsoft Learn MCP server is not available.

Category Index

Category	Lines	Description
Troubleshooting	L31-L42	Diagnosing and fixing Event Hubs runtime issues: Kafka/AMQP errors, .NET/legacy exceptions, ARM failures, auth problems, checkpoint store, and connectivity (transient/permanent).
Best Practices	L44-L48	Guidance on routing events between AMQP, Kafka, and HTTPS, and on designing/scaling Event Hubs with partitions and throughput units for performance and capacity.
Decision Making	L50-L54	Guidance on choosing the right Event Hubs tier and planning migrations from Apache Kafka, including feature, cost, and compatibility considerations.
Architecture & Design Patterns	L56-L62	Patterns and guidance for Event Hubs reliability: availability/consistency design, geo-disaster recovery, and building/operating replication tasks (often with Azure Functions).
Limits & Quotas	L64-L71	Event Hubs capacity, quotas, and throughput limits, plus auto-inflate, geo-disaster recovery, and governance via application groups and FAQs on behavior and scaling.
Security	L73-L98	Security, auth, and compliance for Event Hubs: Entra ID, SAS, RBAC, managed identities, encryption, TLS, network isolation (VNet, Private Link, NSP, firewalls), and Azure Policy governance.
Configuration	L100-L111	Configuring Event Hubs behavior: partitions, retention, compaction, scaling, replication, metrics/logs, governance (application groups), and Premium processing units.
Integrations & Coding Patterns	L113-L129	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
Deployment	L131-L137	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.

Troubleshooting

Topic	URL
Resolve common Kafka compatibility issues in Event Hubs	https://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-frequently-asked-questions
Troubleshoot Azure Event Hubs for Apache Kafka	https://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-troubleshooting-guide
Troubleshoot AMQP errors in Azure Event Hubs	https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-amqp-troubleshoot
Handle legacy Azure Event Hubs messaging exceptions	https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-messaging-exceptions
Handle Azure Event Hubs .NET exceptions and recommended actions	https://learn.microsoft.com/en-us/azure/event-hubs/exceptions-dotnet
Resolve Azure Resource Manager exceptions for Event Hubs operations	https://learn.microsoft.com/en-us/azure/event-hubs/resource-manager-exceptions
Troubleshoot authentication and authorization failures in Event Hubs	https://learn.microsoft.com/en-us/azure/event-hubs/troubleshoot-authentication-authorization
Resolve Blob Storage checkpoint store issues for Event Hubs	https://learn.microsoft.com/en-us/azure/event-hubs/troubleshoot-checkpoint-store-issues
Troubleshoot permanent and transient connectivity issues in Event Hubs	https://learn.microsoft.com/en-us/azure/event-hubs/troubleshooting-guide

Best Practices

Topic	URL
Exchange Event Hubs events across AMQP, Kafka, and HTTPS	https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-exchange-events-different-protocols
Scale Azure Event Hubs with partitions and throughput units	https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-scalability

Decision Making

Topic	URL
Plan migration from Apache Kafka to Event Hubs	https://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-migration-guide
Choose the right Azure Event Hubs tier	https://learn.microsoft.com/en-us/azure/event-hubs/compare-tiers

Architecture & Design Patterns

Topic	URL
Design for availability and consistency in Event Hubs	https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-availability-and-consistency
Apply Event Hubs event replication task patterns	https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-federation-patterns
Design Event Hubs replication tasks with Azure Functions	https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-federation-replicator-functions
Plan Event Hubs geo-disaster recovery strategy	https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-geo-dr

Limits & Quotas

Topic	URL
Configure Event Hubs auto-inflate throughput unit limits	https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-auto-inflate
Azure Event Hubs FAQ including limits and behavioral details	https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-faq
Review Azure Event Hubs quotas and limits	https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-quotas
Use Event Hubs geo-replication for DR	https://learn.microsoft.com/en-us/azure/event-hubs/geo-replication
Govern Event Hubs resources with application groups	https://learn.microsoft.com/en-us/azure/event-hubs/resource-governance-overview

Security

Topic	URL
Associate network security perimeters with Event Hubs namespaces	https://learn.microsoft.com/en-us/azure/event-hubs/associate-network-security-perimeter
Authenticate applications with Entra ID for Event Hubs	https://learn.microsoft.com/en-us/azure/event-hubs/authenticate-application
Authenticate to Event Hubs using managed identities	https://learn.microsoft.com/en-us/azure/event-hubs/authenticate-managed-identity
Authenticate to Event Hubs using SAS tokens	https://learn.microsoft.com/en-us/azure/event-hubs/authenticate-shared-access-signature
Authorize Event Hubs access using Entra RBAC roles	https://learn.microsoft.com/en-us/azure/event-hubs/authorize-access-azure-active-directory
Choose authorization options for Azure Event Hubs	https://learn.microsoft.com/en-us/azure/event-hubs/authorize-access-event-hubs
Authorize Event Hubs access with SAS rules	https://learn.microsoft.com/en-us/azure/event-hubs/authorize-access-shared-access-signature
Configure customer-managed keys for Event Hubs encryption at rest	https://learn.microsoft.com/en-us/azure/event-hubs/configure-customer-managed-key
Enable and configure managed identities for Event Hubs namespaces	https://learn.microsoft.com/en-us/azure/event-hubs/enable-managed-identity
Configure managed identity for Event Hubs Capture	https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-capture-managed-identity
Obtain secure connection strings for Azure Event Hubs	https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-get-connection-string
Configure IP firewall rules for Azure Event Hubs	https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-ip-filtering
Secure Event Hubs with virtual network service endpoints	https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-service-endpoints
Configure network security for Azure Event Hubs	https://learn.microsoft.com/en-us/azure/event-hubs/network-security
Secure Event Hubs with Network Security Perimeter	https://learn.microsoft.com/en-us/azure/event-hubs/network-security-perimeter
Migrate Event Hubs apps to passwordless authentication with Entra ID	https://learn.microsoft.com/en-us/azure/event-hubs/passwordless-migration-event-hubs
Use built-in Azure Policy definitions for Event Hubs governance	https://learn.microsoft.com/en-us/azure/event-hubs/policy-reference
Restrict Event Hubs access using Private Link endpoints	https://learn.microsoft.com/en-us/azure/event-hubs/private-link-service
Apply regulatory compliance policies to Event Hubs	https://learn.microsoft.com/en-us/azure/event-hubs/security-controls-policy
Audit Event Hubs TLS compliance using Azure Policy	https://learn.microsoft.com/en-us/azure/event-hubs/transport-layer-security-audit-minimum-version
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
Set minimum TLS version for Azure Event Hubs namespaces	https://learn.microsoft.com/en-us/azure/event-hubs/transport-layer-security-configure-minimum-version
Enforce minimum TLS version for Event Hubs	https://learn.microsoft.com/en-us/azure/event-hubs/transport-layer-security-enforce-minimum-version

Configuration

Topic	URL
Configure partitioning, retention, and cleanup for Event Hubs	https://learn.microsoft.com/en-us/azure/event-hubs/configure-event-hub-properties
Configure processing units for Event Hubs Premium	https://learn.microsoft.com/en-us/azure/event-hubs/configure-processing-units-premium-namespace
Dynamically increase partitions in an Event Hub	https://learn.microsoft.com/en-us/azure/event-hubs/dynamically-add-partitions
Configure code-free Event Hubs replication tasks	https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-federation-configuration
Understand and use Event Hubs captured Avro schema	https://learn.microsoft.com/en-us/azure/event-hubs/explore-captured-avro-files
Configure Azure Monitor metrics and alerts for Event Hubs	https://learn.microsoft.com/en-us/azure/event-hubs/monitor-event-hubs
Reference for Event Hubs metrics, logs, and diagnostic settings	https://learn.microsoft.com/en-us/azure/event-hubs/monitor-event-hubs-reference
Configure Event Hubs application groups for resource governance	https://learn.microsoft.com/en-us/azure/event-hubs/resource-governance-with-app-groups
Configure and use log compaction in Azure Event Hubs	https://learn.microsoft.com/en-us/azure/event-hubs/use-log-compaction

Integrations & Coding Patterns

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

Deployment

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