Azure Messaging
作者 microsoft354361d83247MIT收录于 2026年10月8日更新于 2026年10月8日
Troubleshoot and resolve issues with Azure Messaging SDKs for Event Hubs and Service Bus. Covers connection failures, authentication errors, message processing issues, and SDK configuration problems. WHEN: event hub SDK error, service bus SDK issue, messaging connection failure, AMQP error, event processor host issue, message lock lost, message lock expired, lock renewal, lock renewal batch, send timeout, receiver disconnected, SDK troubleshooting, azure messaging SDK, event hub consumer, service bus queue issue, topic subscription error, enable logging event hub, service bus logging, eventhub python, servicebus java, eventhub javascript, servicebus dotnet, event hub checkpoint, event hub not receiving messages, service bus dead letter, batch processing lock, session lock expired, idle timeout, connection inactive, link detach, slow reconnect, session error, duplicate events, offset reset, receive batch.
排查并解决 Azure 事件中心和 Service Bus SDK 的连接、身份验证和消息处理问题。
- 功能
- 该技能为事件中心和 Service Bus 的 Azure 消息 SDK 问题提供诊断流程。流程包括确认 SDK 及版本、检查资源运行状况、将错误信息与特定语言的排查指南匹配、检索 Microsoft Learn 文档、核对配置并给出修复建议。涵盖连接失败、AMQP 链接错误、锁与会话过期、检查点和偏移量问题以及 SDK 配置问题。
- 适用场景
- 当 Azure 事件中心或 Service Bus SDK 出现连接失败、身份验证错误、AMQP 分离或空闲超时、消息或会话锁丢失、重复事件、偏移量重置或事件处理器停止处理时使用。也适用于有关重试、预取和批大小等 SDK 配置的问题。
- 运行要求
- 需要访问用于事件中心、Service Bus、Monitor 日志查询、Resource Health 和 Microsoft Learn 文档搜索的 Azure MCP 工具。该技能不包含脚本；其指向的排查指南位于单独的 azure-diagnostics 技能中。
Azure Messaging SDK Troubleshooting
Quick Reference
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)
MCP Tools
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
mcp_azure_mcp_resourcehealth to verify the namespace is healthy
- Review the error message — Match against language-specific troubleshooting guide
- Look up documentation — Use
mcp_azure_mcp_documentation to search Microsoft Learn for the error or topic
- Check configuration — Verify connection string, entity name, consumer group
- Recommend fix — Apply remediation, citing documentation found
Troubleshooting Guides
Connectivity, SDK, and auth troubleshooting guides are located in the azure-diagnostics skill under troubleshooting/messaging/.
References
- Use
mcp_azure_mcp_documentation to search Microsoft Learn for latest guidance.
