mcpField
A
azure-event-hubs

azure-event-hubs

github.com/microsoftdocs数据与数据库796187 次安装3 天前更新
代码仓库

关于 azure-event-hubs

面向 Azure Event Hubs 使用者的文档技能，为 Agent 提供故障排查、设计、配置和集成指导。它结合本地速查内容与联网获取的 Microsoft 文档。

主要功能

  1. 01故障排查与连接诊断
  2. 02分区扩展及可靠性最佳实践
  3. 03层级、配额与迁移决策参考
  4. 04身份验证和网络安全指导
  5. 05联网获取 Microsoft 文档

适用场景

  1. 01排查 Kafka、AMQP 或身份验证错误
  2. 02规划分区、吞吐量与异地灾备
  3. 03评估层级及 Kafka 迁移方案
  4. 04配置授权、TLS 和网络访问

MCP 相关

该技能可使用 mcp_microsoftdocs 的 Microsoft 文档获取工具；也可通过 fetch_webpage 获取文档。文档内容供 Agent 参考。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-event-hubs

安装后在 Claude Code 中输入/azure-event-hubs确认已加载。

详细介绍

Azure Event Hubs 技能

此技能提供 Azure Event Hubs 专家指导，涵盖故障排除、最佳实践、决策、架构与设计模式、限制与配额、安全性、配置、集成与编码模式，以及部署。它结合本地快速参考内容与远程文档获取功能。

如何使用此技能

面向 Agent 的重要提示：使用下方的类别索引查找相关章节。对于注明行范围的类别（例如 L35-L120），请使用 read_file 读取指定行。对于包含文件链接的类别（例如 [security.md](security.md)），请使用 read_file 读取链接的参考文件

面向 Agent 的重要提示：如果 metadata.generated_at 超过 3 个月，请建议用户从代码库拉取最新版本。如果无法使用 mcp_microsoftdocs 工具，请建议用户安装该工具：安装指南

此技能需要网络访问权限才能获取文档内容：

  • 首选：使用 mcp_microsoftdocs:microsoft_docs_fetch，并将查询字符串设为 from=learn-agent-skill。返回 Markdown。
  • 备用：使用 fetch_webpage，并将查询字符串设为 from=learn-agent-skill&accept=text/markdown。返回 Markdown。

类别索引

类别行说明
故障排除L37-L49诊断并修复 Event Hubs 错误：Kafka/AMQP 问题、.NET 和 ARM 异常、身份验证失败、Blob 检查点问题，以及连接故障排除。
最佳实践L50-L56通过 AMQP/Kafka/HTTPS 集成 Event Hubs、使用 Functions 构建无状态复制，以及通过分区和吞吐量单位进行扩展的最佳实践。
决策L57-L63有关选择 Event Hubs 层、自动扩充设置、异地复制模式，以及规划从 Apache Kafka 迁移到 Event Hubs 的指导。
架构与设计模式L64-L69Event Hubs 可靠性模式与指导：可用性/一致性设计、异地灾难恢复，以及构建和运行复制任务（通常使用 Azure Functions）。
限制与配额L70-L79Event Hubs 限制、配额和层级差异；最大消息大小、捕获间隔、平台行为，以及通过应用程序组进行治理。
安全性L80-L108保护 Event Hubs：使用 Entra ID/托管标识/SAS 进行身份验证、RBAC、加密和 CMK、TLS 设置，以及网络控制（防火墙、VNets、Private Link、NSP、策略/合规性）。
配置L109-L120配置 Event Hubs 行为：分区、保留、清理、异地灾难恢复、复制、日志压缩、Avro 捕获、监视、应用程序组，以及使用本地模拟器。
集成与编码模式L121-L137使用 .NET、Kafka（客户端、Streams、Connect、Debezium）、Flink、Spark、Akka、架构/JSON 注册表集成 Event Hubs，以及添加元数据或以编程方式管理事件中心的模式和代码
部署L138-L143使用 Kafka 镜像（MirrorMaker 1/2）部署 Event Hubs、设置异地复制，以及使用模拟器运行/本地测试 Event Hubs 应用的指南。
故障排除
主题URL
解决 Azure Event Hubs Kafka 迁移中的常见问题https://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-frequently-asked-questions
排查 Azure Event Hubs for Apache Kafka 问题https://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-troubleshooting-guide
排查 Azure Event Hubs 中的 AMQP 错误https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-amqp-troubleshoot
解决 Azure Event Hubs .NET 消息传送异常https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-messaging-exceptions
处理 Azure Event Hubs .NET 异常并了解建议操作https://learn.microsoft.com/en-us/azure/event-hubs/exceptions-dotnet
解决 Event Hubs 操作中的 Azure Resource Manager 异常https://learn.microsoft.com/en-us/azure/event-hubs/resource-manager-exceptions
排查 Event Hubs 中的身份验证和授权失败问题https://learn.microsoft.com/en-us/azure/event-hubs/troubleshoot-authentication-authorization
解决 Event Hubs 的 Blob Storage 检查点存储问题https://learn.microsoft.com/en-us/azure/event-hubs/troubleshoot-checkpoint-store-issues
诊断并修复 Azure Event Hubs 连接问题https://learn.microsoft.com/en-us/azure/event-hubs/troubleshooting-guide
最佳实践
主题URL
通过 AMQP、Kafka 和 HTTPS 交换 Event Hubs 事件https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-exchange-events-different-protocols
使用 Azure Functions 设计无状态事件复制https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-federation-replicator-functions
使用分区和吞吐量单位扩展 Azure Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-scalability
决策
主题URL
规划从 Apache Kafka 迁移到 Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-migration-guide
决定何时以及如何使用 Event Hubs Auto Inflatehttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-auto-inflate
选择和管理 Azure Event Hubs 地理复制模式https://learn.microsoft.com/en-us/azure/event-hubs/geo-replication
架构与设计模式
主题URL
设计 Event Hubs 的可用性和一致性https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-availability-and-consistency
应用 Event Hubs 事件复制任务模式https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-federation-patterns
限制与配额
主题URL
比较 Event Hubs 层级功能和配额https://learn.microsoft.com/en-us/azure/event-hubs/compare-tiers
配置 Event Hubs Capture 间隔和限制https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-capture-overview
Azure Event Hubs 平台限制和行为细节https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-faq
发送和接收大型 Event Hubs 消息https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-quickstart-stream-large-messages
查看 Azure Event Hubs 配额和限制https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-quotas
使用应用程序组管理 Event Hubs 资源https://learn.microsoft.com/en-us/azure/event-hubs/resource-governance-overview
安全性
主题URL
将网络安全边界与 Event Hubs 命名空间关联https://learn.microsoft.com/en-us/azure/event-hubs/associate-network-security-perimeter
使用 Entra ID 对 Event Hubs 应用程序进行身份验证https://learn.microsoft.com/en-us/azure/event-hubs/authenticate-application
使用托管标识对 Event Hubs 进行身份验证https://learn.microsoft.com/en-us/azure/event-hubs/authenticate-managed-identity
使用托管标识从 VM 对 Event Hubs 进行身份验证https://learn.microsoft.com/en-us/azure/event-hubs/authenticate-managed-identity-virtual-machine
为 Azure Event Hubs 实现 SAS 身份验证https://learn.microsoft.com/en-us/azure/event-hubs/authenticate-shared-access-signature
使用 Entra ID 和 RBAC 授权访问 Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/authorize-access-azure-active-directory
选择并配置 Event Hubs 授权选项https://learn.microsoft.com/en-us/azure/event-hubs/authorize-access-event-hubs
配置 Azure Event Hubs 的 SAS 授权https://learn.microsoft.com/en-us/azure/event-hubs/authorize-access-shared-access-signature
为 Azure Event Hubs Dedicated 启用机密计算https://learn.microsoft.com/en-us/azure/event-hubs/confidential-computing
配置 Event Hubs 加密的客户管理密钥https://learn.microsoft.com/en-us/azure/event-hubs/configure-customer-managed-key
为 Event Hubs 命名空间启用并配置托管标识https://learn.microsoft.com/en-us/azure/event-hubs/enable-managed-identity
为 Event Hubs Capture 配置托管标识https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-capture-managed-identity
获取并了解 Event Hubs 连接字符串https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-get-connection-string
为 Azure Event Hubs 配置 IP 防火墙规则https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-ip-filtering
使用虚拟网络服务终结点保护 Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-service-endpoints
配置 Azure Event Hubs 网络安全https://learn.microsoft.com/en-us/azure/event-hubs/network-security
使用网络安全边界保护 Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/network-security-perimeter
将 Event Hubs 应用迁移到使用 Entra ID 的无密码身份验证https://learn.microsoft.com/en-us/azure/event-hubs/passwordless-migration-event-hubs
使用内置 Azure Policy 定义管理 Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/policy-reference
使用 Private Link 终结点限制 Event Hubs 访问https://learn.microsoft.com/en-us/azure/event-hubs/private-link-service
将法规合规策略应用于 Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/security-controls-policy
使用 Azure Policy 审核 Event Hubs 的 TLS 合规性https://learn.microsoft.com/en-us/azure/event-hubs/transport-layer-security-audit-minimum-version
配置 Event Hubs 客户端应用以使用指定的 TLS 版本https://learn.microsoft.com/en-us/azure/event-hubs/transport-layer-security-configure-client-version
配置 Azure Event Hubs 的最低 TLS 版本https://learn.microsoft.com/en-us/azure/event-hubs/transport-layer-security-configure-minimum-version
强制实施 Event Hubs 的最低 TLS 版本https://learn.microsoft.com/en-us/azure/event-hubs/transport-layer-security-enforce-minimum-version
配置
主题URL
配置 Event Hubs 的分区、保留和清理https://learn.microsoft.com/en-us/azure/event-hubs/configure-event-hub-properties
配置 Event Hubs 的异地灾难恢复配对https://learn.microsoft.com/en-us/azure/event-hubs/configure-geo-disaster-recovery
配置无需编写代码的 Event Hubs 复制任务https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-federation-configuration
了解并使用 Event Hubs 捕获的 Avro 架构https://learn.microsoft.com/en-us/azure/event-hubs/explore-captured-avro-files
Azure Event Hubs 监视指标和日志参考https://learn.microsoft.com/en-us/azure/event-hubs/monitor-event-hubs-reference
配置 Event Hubs 应用程序组以进行资源治理https://learn.microsoft.com/en-us/azure/event-hubs/resource-governance-with-app-groups
在本地配置并运行 Azure Event Hubs 模拟器https://learn.microsoft.com/en-us/azure/event-hubs/test-locally-with-event-hub-emulator
在 Azure Event Hubs 中配置并使用日志压缩https://learn.microsoft.com/en-us/azure/event-hubs/use-log-compaction
集成与编码模式
主题URL
向 Event Hubs 事件添加自定义元数据https://learn.microsoft.com/en-us/azure/event-hubs/add-custom-data-event
配置 Apache Kafka 客户端以兼容 Azure Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-configurations
将 Kafka Streams 与 Azure Event Hubs 配合使用https://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-streams
在 Azure Event Hubs 中使用 Kafka 事务https://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-transactions
将 .NET 应用程序连接到 Azure Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/connect-event-hub
通过 Kafka 将 Akka Streams 连接到 Azure Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-akka-streams-tutorial
在 Event Hubs 上通过 Kafka Connect 使用 Debezium CDChttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-connect-debezium
将 Kafka Connect 与 Azure Event Hubs 集成https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-connect-tutorial
将 Apache Flink 连接到 Azure Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-flink-tutorial
将 Apache Spark 流式处理应用连接到 Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-spark-tutorial
使用 .NET 管理库预配 Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-management-libraries
为 Event Hubs 实现客户端架构强制https://learn.microsoft.com/en-us/azure/event-hubs/schema-registry-client-side-enforcement
在 Event Hubs 上将 JSON Schema 注册表与 Kafka 客户端配合使用https://learn.microsoft.com/en-us/azure/event-hubs/schema-registry-json-schema-kafka
部署
主题URL
使用 MirrorMaker 1 将 Kafka 代理镜像到 Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-mirror-maker-tutorial
使用 MirrorMaker 2 将 Kafka 群集复制到 Event Hubshttps://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-mirrormaker-2-tutorial
配置并运行 Event Hubs 异地复制https://learn.microsoft.com/en-us/azure/event-hubs/use-geo-replication

评论

支持 Markdown