azure-messaging
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseAzure Messaging SDK Troubleshooting
Azure Messaging SDK故障排查
Quick Reference
快速参考
| Property | Value |
|---|---|
| Services | Azure Event Hubs, Azure Service Bus |
| MCP Tools | |
| Best For | Diagnosing SDK connection, auth, and message processing issues |
| 属性 | 数值 |
|---|---|
| 适用服务 | Azure Event Hubs, Azure Service Bus |
| MCP工具 | |
| 最佳适用场景 | 诊断SDK连接、认证和消息处理问题 |
When to Use This Skill
何时使用该技能
- SDK connection failures, auth errors, or AMQP link errors
- Idle timeout, connection inactivity, or slow reconnection after disconnect
- AMQP link detach or detach-forced errors
- Message lock lost, message lock expired, lock renewal failures, or batch lock timeouts
- Session lock lost, session lock expired, or session receiver errors
- Event processor or message handler stops processing
- Duplicate events or checkpoint offset resets
- SDK configuration questions (retry, prefetch, batch size, receive batch behavior)
- SDK连接失败、认证错误或AMQP链接错误
- 空闲超时、连接不活跃,或断开连接后重连缓慢
- AMQP链接分离或强制分离错误
- 消息锁丢失、消息锁过期、锁续订失败,或批量锁超时
- 会话锁丢失、会话锁过期,或会话接收器错误
- 事件处理器或消息处理器停止处理
- 重复事件或检查点偏移量重置
- SDK配置相关问题(重试、预取、批量大小、批量接收行为)
MCP Tools
MCP工具
| Tool | Command | Use |
|---|---|---|
| Namespace/hub ops | List namespaces, hubs, consumer groups |
| Queue/topic ops | List namespaces, queues, topics, subscriptions |
| | Query diagnostic logs with KQL |
| | Check service health status |
| Doc search | Search Microsoft Learn for troubleshooting docs |
| 工具 | 命令 | 用途 |
|---|---|---|
| 命名空间/事件中心操作 | 列出命名空间、事件中心、消费者组 |
| 队列/主题操作 | 列出命名空间、队列、主题、订阅 |
| | 用KQL查询诊断日志 |
| | 检查服务健康状态 |
| 文档搜索 | 在Microsoft Learn中搜索故障排查文档 |
Diagnosis Workflow
诊断工作流
- Identify the SDK and version — Check the prompt for SDK and version clues; if not stated, proceed with diagnosis and ask later if needed
- Check resource health — Use to verify the namespace is healthy
mcp_azure_mcp_resourcehealth - Review the error message — Match against language-specific troubleshooting guide
- Look up documentation — Use to search Microsoft Learn for the error or topic
mcp_azure_mcp_documentation - Check configuration — Verify connection string, entity name, consumer group
- Recommend fix — Apply remediation, citing documentation found
- 识别SDK及版本 — 从提示中查找SDK和版本相关线索,如果没有说明,先继续排查,后续必要时再询问
- 检查资源健康状态 — 使用验证命名空间运行正常
mcp_azure_mcp_resourcehealth - 查看错误消息 — 匹配对应语言的故障排查指南
- 查找文档 — 使用在Microsoft Learn中搜索相关错误或主题
mcp_azure_mcp_documentation - 检查配置 — 验证连接字符串、实体名称、消费者组
- 推荐修复方案 — 实施修复措施,引用查找到的相关文档
Connectivity Troubleshooting
连接故障排查
See Service Troubleshooting Guide for ports, WebSocket fallback, IP firewall, private endpoints, and service tags.
参见服务故障排查指南了解端口、WebSocket回退、IP防火墙、私有端点和服务标签相关内容。
SDK Troubleshooting Guides
SDK故障排查指南
- Event Hubs: Python | Java | JS | .NET
- Service Bus: Python | Java | JS | .NET
- Event Hubs: Python | Java | JS | .NET
- Service Bus: Python | Java | JS | .NET
References
参考资料
Use to search Microsoft Learn for latest guidance. See Service Troubleshooting Guide for network and service-level docs.
mcp_azure_mcp_documentation使用在Microsoft Learn中搜索最新指南。参见服务故障排查指南了解网络和服务级别的相关文档。
mcp_azure_mcp_documentation