安装方式
命令行安装
在项目根目录执行以下命令，完成 Skill 安装。
npx bzskills add microsoft/azure-skills --skill azure-messaging
返回全部 Skills
azure-messaging
开发工具
官方认证
排查和解决 Azure 事件中心与服务总线的消息传递 SDK 问题。涵盖连接失败、身份验证错误、消息处理问题及 SDK 配置问题。适用场景：事件中心 SDK 错误、服务总线 SDK 问题、消息传递连接失败、AMQP 错误、事件处理器主机问题、消息锁丢失、消息锁过期、锁续订、批处理锁续订、发送超时、接收器断开连接、SDK 故障排除、Azure 消息传递 SDK、事件中心消费者、服务总线队列问题、主题订阅错误、启用事件中心日志记录、服务总线日志记录、eventhub python、servicebus java、eventhub javascript、servicebus dotnet、事件中心检查点、事件中心未接收消息、服务总线死信、批处理锁、会话锁过期、空闲超时、连接不活跃、链路分离、缓慢重连、会话错误、重复事件、偏移量重置、接收批处理。
288.7k
下载量
skill.md
name: azure-messaging
description: 排查和解决 Azure 事件中心与服务总线的消息传递 SDK 问题。涵盖连接失败、身份验证错误、消息处理问题及 SDK 配置问题。适用场景：事件中心 SDK 错误、服务总线 SDK 问题、消息传递连接失败、AMQP 错误、事件处理器主机问题、消息锁丢失、消息锁过期、锁续订、批处理锁续订、发送超时、接收器断开连接、SDK 故障排除、Azure 消息传递 SDK、事件中心消费者、服务总线队列问题、主题订阅错误、启用事件中心日志记录、服务总线日志记录、eventhub python、servicebus java、eventhub javascript、servicebus dotnet、事件中心检查点、事件中心未接收消息、服务总线死信、批处理锁、会话锁过期、空闲超时、连接不活跃、链路分离、缓慢重连、会话错误、重复事件、偏移量重置、接收批处理。
license: MIT
metadata:
author: Microsoft
version: "1.1.2"Azure 消息传递 SDK 故障排除
快速参考
| 属性 | 值 |
|---|---|
| 服务 | Azure 事件中心、Azure 服务总线 |
| MCP 工具 | mcp_azure_mcp_eventhubs, mcp_azure_mcp_servicebus |
| 适用场景 | 诊断 SDK 连接、身份验证和消息处理问题 |
何时使用此技能
- SDK 连接失败、身份验证错误或 AMQP 链接错误
- 空闲超时、连接无活动或断开后重新连接缓慢
- AMQP 链接分离或强制分离错误
- 消息锁丢失、消息锁过期、锁续约失败或批量锁超时
- 会话锁丢失、会话锁过期或会话接收器错误
- 事件处理器或消息处理程序停止处理
- 重复事件或检查点偏移重置
- SDK 配置问题（重试、预取、批量大小、接收批处理行为）
MCP 工具
| 工具 | 命令 | 用途 |
|---|---|---|
mcp_azure_mcp_eventhubs | 命名空间/事件中心操作 | 列出命名空间、事件中心、消费组 |
mcp_azure_mcp_servicebus | 队列/主题操作 | 列出命名空间、队列、主题、订阅 |
mcp_azure_mcp_monitor | logs_query | 使用 KQL 查询诊断日志 |
mcp_azure_mcp_resourcehealth | get | 检查服务运行状况 |
mcp_azure_mcp_documentation | 文档搜索 | 搜索 Microsoft Learn 上的故障排除文档 |
诊断工作流
- 识别 SDK 和版本 — 检查提示中是否有 SDK 及版本信息；若无，先进行诊断，如有需要后续再询问
- 检查资源运行状况 — 使用
mcp_azure_mcp_resourcehealth验证命名空间是否正常 - 查看错误消息 — 对照特定语言的故障排除指南进行匹配
- 查找文档 — 使用
mcp_azure_mcp_documentation在 Microsoft Learn 上搜索相关错误或主题 - 检查配置 — 验证连接字符串、实体名称、消费组
- 建议修复 — 应用补救措施，并引用找到的文档
故障排除指南
连接性、SDK 和身份验证故障排除指南位于 azure-diagnostics 技能的 troubleshooting/messaging/ 目录下。
参考文献
- 使用
mcp_azure_mcp_documentation在 Microsoft Learn 上搜索最新指南。