azure-messaging

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Azure Messaging SDK Troubleshooting

Azure Messaging SDK故障排查

Quick Reference

快速参考

PropertyValue
ServicesAzure Event Hubs, Azure Service Bus
MCP Tools
mcp_azure_mcp_eventhubs
,
mcp_azure_mcp_servicebus
Best ForDiagnosing SDK connection, auth, and message processing issues
属性数值
适用服务Azure Event Hubs, Azure Service Bus
MCP工具
mcp_azure_mcp_eventhubs
,
mcp_azure_mcp_servicebus
最佳适用场景诊断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工具

ToolCommandUse
mcp_azure_mcp_eventhubs
Namespace/hub opsList namespaces, hubs, consumer groups
mcp_azure_mcp_servicebus
Queue/topic opsList namespaces, queues, topics, subscriptions
mcp_azure_mcp_monitor
logs_query
Query diagnostic logs with KQL
mcp_azure_mcp_resourcehealth
get
Check service health status
mcp_azure_mcp_documentation
Doc searchSearch Microsoft Learn for troubleshooting docs
工具命令用途
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中搜索故障排查文档

Diagnosis Workflow

诊断工作流

  1. Identify the SDK and version — Check the prompt for SDK and version clues; if not stated, proceed with diagnosis and ask later if needed
  2. Check resource health — Use
    mcp_azure_mcp_resourcehealth
    to verify the namespace is healthy
  3. Review the error message — Match against language-specific troubleshooting guide
  4. Look up documentation — Use
    mcp_azure_mcp_documentation
    to search Microsoft Learn for the error or topic
  5. Check configuration — Verify connection string, entity name, consumer group
  6. Recommend fix — Apply remediation, citing documentation found
  1. 识别SDK及版本 — 从提示中查找SDK和版本相关线索,如果没有说明,先继续排查,后续必要时再询问
  2. 检查资源健康状态 — 使用
    mcp_azure_mcp_resourcehealth
    验证命名空间运行正常
  3. 查看错误消息 — 匹配对应语言的故障排查指南
  4. 查找文档 — 使用
    mcp_azure_mcp_documentation
    在Microsoft Learn中搜索相关错误或主题
  5. 检查配置 — 验证连接字符串、实体名称、消费者组
  6. 推荐修复方案 — 实施修复措施,引用查找到的相关文档

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
mcp_azure_mcp_documentation
to search Microsoft Learn for latest guidance. See Service Troubleshooting Guide for network and service-level docs.
使用
mcp_azure_mcp_documentation
在Microsoft Learn中搜索最新指南。参见服务故障排查指南了解网络和服务级别的相关文档。