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
- Message lock lost, session lock, or send/receive timeouts
- Event processor or message handler stops processing
- SDK configuration questions (retry, prefetch, batch size)
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 — Ask which language SDK and version the user is on
- Check resource health — Use
mcp_azure_mcp_resourcehealthto verify the namespace is healthy - Review the error message — Match against language-specific troubleshooting guide
- Look up documentation — Use
mcp_azure_mcp_documentationto search Microsoft Learn for the error or topic - Check configuration — Verify connection string, entity name, consumer group
- Recommend fix — Apply remediation, citing documentation found
Connectivity Troubleshooting
See [Service Troubleshooting Guide](references/service-troubleshooting.md) for ports, WebSocket fallback, IP firewall, private endpoints, and service tags.
SDK Troubleshooting Guides
- Event Hubs: [Python](references/sdk/azure-eventhubs-py.md) | [Java](references/sdk/azure-eventhubs-java.md) | [JS](references/sdk/azure-eventhubs-js.md) | [.NET](references/sdk/azure-eventhubs-dotnet.md)
- Service Bus: [Python](references/sdk/azure-servicebus-py.md) | [Java](references/sdk/azure-servicebus-java.md) | [JS](references/sdk/azure-servicebus-js.md) | [.NET](references/sdk/azure-servicebus-dotnet.md)
References
Use mcp_azure_mcp_documentation to search Microsoft Learn for latest guidance. See [Service Troubleshooting Guide](references/service-troubleshooting.md) for network and service-level docs.