1# Azure Messaging Troubleshooting
2 
3Diagnose and resolve issues with Azure Event Hubs and Service Bus SDKs.
4 
5## Routing
6 
7| Symptom | Guide |
8|---------|-------|
9| Connection failures, firewall, IP/VNet, WebSocket | [service-troubleshooting.md](service-troubleshooting.md) |
10| SDK-specific errors (see language below) | Language guide |
11 
12## SDK Troubleshooting by Language
13 
14- **Event Hubs**: [Python](azure-eventhubs-py.md) | [Java](azure-eventhubs-java.md) | [JS](azure-eventhubs-js.md) | [.NET](azure-eventhubs-dotnet.md)
15- **Service Bus**: [Python](azure-servicebus-py.md) | [Java](azure-servicebus-java.md) | [JS](azure-servicebus-js.md) | [.NET](azure-servicebus-dotnet.md)
16 
17## Common Issues
18 
19| Issue | Category |
20|-------|----------|
21| AMQP link detach, idle timeout, connection inactive | [service-troubleshooting.md](service-troubleshooting.md) |
22| Message lock lost/expired, lock renewal failures | Language-specific SDK guide |
23| Session lock errors, session receiver detach | Language-specific SDK guide |
24| Duplicate events, checkpoint/offset reset | Language-specific SDK guide |
25| Batch >1 MB rejected, partition key conflicts | [service-troubleshooting.md](service-troubleshooting.md) |
26 
27## MCP Tools
28 
29| Tool | Use |
30|------|-----|
31| `mcp_azure_mcp_eventhubs` | List namespaces, hubs, consumer groups |
32| `mcp_azure_mcp_servicebus` | List namespaces, queues, topics, subscriptions |
33| `mcp_azure_mcp_monitor` | Query diagnostic logs with KQL |
34| `mcp_azure_mcp_resourcehealth` | Check service health status |
35| `mcp_azure_mcp_documentation` | Search Microsoft Learn for troubleshooting docs |
36