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_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

Connectivity Troubleshooting

See Service Troubleshooting Guide for ports, WebSocket fallback, IP firewall, private endpoints, and service tags.

SDK Troubleshooting Guides

• Event Hubs: Python | Java | JS | .NET

• Service Bus: Python | Java | JS | .NET

References

Use mcp_azure_mcp_documentation to search Microsoft Learn for latest guidance. See Service Troubleshooting Guide for network and service-level docs.