azure-messaging
热门排查并解决 Azure 消息传递 SDK（适用于事件中心和服务总线）的问题。涵盖连接失败、身份验证错误、消息处理问题以及 SDK 配置问题。适用场景：事件中心 SDK 错误、服务总线 SDK 问题、消息传递连接失败、AMQP 错误、事件处理器主机问题、消息锁丢失、消息锁过期、锁续订、锁续订批处理、发送超时、接收器断开连接、SDK 故障排除、Azure 消息传递 SDK、事件中心消费者、服务总线队列问题、主题订阅错误、启用事件中心日志记录、服务总线日志记录、eventhub python、servicebus java、eventhub javascript、servicebus dotnet、事件中心检查点、事件中心未接收消息、服务总线死信、批处理锁、会话锁过期、空闲超时、连接不活动、链路分离、慢速重新连接、会话错误、重复事件、偏移量重置、接收批处理。
排查并解决 Azure 消息传递 SDK（适用于事件中心和服务总线）的问题。涵盖连接失败、身份验证错误、消息处理问题以及 SDK 配置问题。适用场景：事件中心 SDK 错误、服务总线 SDK 问题、消息传递连接失败、AMQP 错误、事件处理器主机问题、消息锁丢失、消息锁过期、锁续订、锁续订批处理、发送超时、接收器断开连接、SDK 故障排除、Azure 消息传递 SDK、事件中心消费者、服务总线队列问题、主题订阅错误、启用事件中心日志记录、服务总线日志记录、eventhub python、servicebus java、eventhub javascript、servicebus dotnet、事件中心检查点、事件中心未接收消息、服务总线死信、批处理锁、会话锁过期、空闲超时、连接不活动、链路分离、慢速重新连接、会话错误、重复事件、偏移量重置、接收批处理。
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 上搜索最新指南。
