关于 azure-messaging
Azure Messaging SDK Troubleshooting 是一个用于诊断 Azure Event Hubs 与 Azure Service Bus SDK 问题的 skill。它面向遇到连接、认证、AMQP 链路或消息处理异常的开发者，按固定流程检查资源健康、错误信息与配置。
主要功能
- 01诊断 SDK 连接、认证与 AMQP 链路错误
- 02处理消息锁与会话锁丢失或过期问题
- 03排查事件处理器停止处理与重复事件
- 04检查资源健康状态并搜索 Microsoft Learn 文档
适用场景
- 01排查 Event Hubs 空闲超时导致的断连与重连缓慢
- 02处理 Service Bus 消息锁续期失败
- 03定位事件处理器的检查点偏移重置问题
MCP 相关
该 skill 指定使用 mcp_azure_mcp_eventhubs、mcp_azure_mcp_servicebus、mcp_azure_mcp_monitor 等 Azure MCP 工具查询命名空间、队列、日志与健康状态。
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/azure-messaging确认已加载。
详细介绍
Azure Messaging SDK 故障排查
快速参考
| 属性 | 值 |
|---|---|
| 服务 | Azure Event Hubs、Azure Service Bus |
| MCP 工具 | mcp_azure_mcp_eventhubs、mcp_azure_mcp_servicebus |
| 最适用于 | 诊断 SDK 连接、身份验证和消息处理问题 |
何时使用此技能
- SDK 连接失败、身份验证错误或 AMQP 链路错误
- 空闲超时、连接不活动或断开连接后重新连接缓慢
- AMQP 链路分离或 detach-forced 错误
- 消息锁丢失、消息锁过期、锁续订失败或批处理锁超时
- 会话锁丢失、会话锁过期或会话接收器错误
- 事件处理器或消息处理程序停止处理
- 事件重复或检查点偏移量重置
- 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 中搜索最新指南。
评论
支持 Markdown