azure-messaging

作者： microsoft

針對Azure Messaging SDK的Event Hubs與Service Bus問題進行疑難排解與解決。涵蓋連線失敗、驗證錯誤、訊息處理問題及SDK設定問題。適用時機：事件中樞SDK錯誤、服務匯流排SDK問題、訊息連線失敗、AMQP錯誤、事件處理器主機問題、訊息鎖定遺失、訊息鎖定過期、鎖定更新、批次鎖定更新、傳送逾時、接收端中斷連線、SDK疑難排解、azure messaging SDK、事件中樞消費者、服務匯流排佇列問題、主題訂閱錯誤、啟用事件中樞記錄、服務匯流排記錄、eventhub python、servicebus java、eventhub javascript、servicebus dotnet、事件中樞檢查點、事件中樞未接收訊息、服務匯流排無效信件、批次處理鎖定、工作階段鎖定過期、閒置逾時、連線無作用、連結分離、緩慢重新連線、工作階段錯誤、重複事件、位移重設、接收批次。

npx skills add https://github.com/microsoft/skills --skill azure-messaging

下載 ZIP GitHub

3.1k

Azure Messaging SDK Troubleshooting

Quick Reference

Property	Value
Services	Azure Event Hubs, Azure Service Bus
MCP Tools	`mcp_azure_mcp_eventhubs`, `mcp_azure_mcp_servicebus`
Best For	Diagnosing SDK connection, auth, and message processing issues

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

Tool	Command	Use
`mcp_azure_mcp_eventhubs`	Namespace/hub ops	List namespaces, hubs, consumer groups
`mcp_azure_mcp_servicebus`	Queue/topic ops	List 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 search	Search Microsoft Learn for troubleshooting docs

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