azure-messaging
Troubleshoot and resolve issues with Azure Messaging SDKs for Event Hubs and Service Bus. Covers connection failures, authentication errors, message processing issues, and SDK configuration problems. WHEN: event hub SDK error, service bus SDK issue, messaging connection failure, AMQP error, event pr
By microsoft · 565,193 installs
npx skills add microsoft/azure-skills --skill azure-messaging
Source repository · Upstream listing
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
1. Identify the SDK and version — Check the prompt for SDK and version clues; if not stated, proceed with diagnosis and ask later if needed
2. Check resource health — Use mcp azure mcp resourcehealth to verify the namespace is healthy
3. Review the error message — Match against language specific troubleshooting guide
4. Look up documentation — Use mcp azure mcp documentation to search Microsoft Learn for the error or topic
5. Check configuration — Verify connection string, entity name, consumer group
6. Recommend fix — Apply remediation, citing documentation found
Troubleshooting Guides
Connectivity, SDK, and auth troubleshooting guides are located in the azure diagnostics skill under troubleshooting/messaging/ .
References
Use mcp azure mcp documentation to search Microsoft Learn for latest guidance.