1---2name: azure-messaging3description: Diagnose and resolve issues with Azure Event Hubs and Service Bus SDKs, including connection failures, authentication errors, message processing problems, and SDK configuration.4license: MIT5---67# Azure Messaging SDK Troubleshooting89## Quick Reference1011| Property | Value |12|----------|-------|13| **Services** | Azure Event Hubs, Azure Service Bus |14| **MCP Tools** | `mcp_azure_mcp_eventhubs`, `mcp_azure_mcp_servicebus` |15| **Best For** | Diagnosing SDK connection, auth, and message processing issues |1617## When to Use This Skill1819- SDK connection failures, auth errors, or AMQP link errors20- Idle timeout, connection inactivity, or slow reconnection after disconnect21- AMQP link detach or detach-forced errors22- Message lock lost, message lock expired, lock renewal failures, or batch lock timeouts23- Session lock lost, session lock expired, or session receiver errors24- Event processor or message handler stops processing25- Duplicate events or checkpoint offset resets26- SDK configuration questions (retry, prefetch, batch size, receive batch behavior)2728## MCP Tools2930| Tool | Command | Use |31|------|---------|-----|32| `mcp_azure_mcp_eventhubs` | Namespace/hub ops | List namespaces, hubs, consumer groups |33| `mcp_azure_mcp_servicebus` | Queue/topic ops | List namespaces, queues, topics, subscriptions |34| `mcp_azure_mcp_monitor` | `logs_query` | Query diagnostic logs with KQL |35| `mcp_azure_mcp_resourcehealth` | `get` | Check service health status |36| `mcp_azure_mcp_documentation` | Doc search | Search Microsoft Learn for troubleshooting docs |3738## Diagnosis Workflow39401. **Identify the SDK and version** — Check the prompt for SDK and version clues; if not stated, proceed with diagnosis and ask later if needed412. **Check resource health** — Use `mcp_azure_mcp_resourcehealth` to verify the namespace is healthy423. **Review the error message** — Match against language-specific troubleshooting guide434. **Look up documentation** — Use `mcp_azure_mcp_documentation` to search Microsoft Learn for the error or topic445. **Check configuration** — Verify connection string, entity name, consumer group456. **Recommend fix** — Apply remediation, citing documentation found464748## Troubleshooting Guides4950Connectivity, SDK, and auth troubleshooting guides are located in the azure-diagnostics skill under `troubleshooting/messaging/`.5152## References5354- Use `mcp_azure_mcp_documentation` to search Microsoft Learn for latest guidance.
Microsoft