About azure-messaging
Azure Messaging SDK Troubleshooting is a skill for diagnosing issues in Azure Event Hubs and Azure Service Bus SDKs. It is aimed at developers facing connection, auth, AMQP link or message processing errors, and follows a fixed diagnosis workflow.
Key features
- 01Diagnoses SDK connection, auth and AMQP link errors
- 02Handles message and session lock loss or expiry
- 03Troubleshoots stopped event processors and duplicate events
- 04Checks resource health and searches Microsoft Learn
Use cases
- 01Investigating Event Hubs idle timeouts and slow reconnection
- 02Resolving Service Bus message lock renewal failures
- 03Locating checkpoint offset resets in event processors
MCP support
The skill directs the use of Azure MCP tools such as mcp_azure_mcp_eventhubs, mcp_azure_mcp_servicebus and mcp_azure_mcp_monitor to list namespaces, queues, logs and health status.
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ microsoft/ azure-skills --skill azure-messagingAfter installing, type/azure-messagingin Claude Code to confirm it loaded.
Details
From the project READMEAzure 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
- Identify the SDK and version — Check the prompt for SDK and version clues; if not stated, proceed with diagnosis and ask later if needed
- 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
Troubleshooting Guides
Connectivity, SDK, and auth troubleshooting guides are located in the azure-diagnostics skill under troubleshooting/messaging/.
References
- Use
mcp_azure_mcp_documentationto search Microsoft Learn for latest guidance.
Comments
Markdown supported