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.
