$npx -y skills add microsoft/azure-skills --skill azure-messagingTroubleshoot 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,
| 1 | # Azure Messaging SDK Troubleshooting |
| 2 | |
| 3 | ## Quick Reference |
| 4 | |
| 5 | | Property | Value | |
| 6 | |----------|-------| |
| 7 | | **Services** | Azure Event Hubs, Azure Service Bus | |
| 8 | | **MCP Tools** | `mcp_azure_mcp_eventhubs`, `mcp_azure_mcp_servicebus` | |
| 9 | | **Best For** | Diagnosing SDK connection, auth, and message processing issues | |
| 10 | |
| 11 | ## When to Use This Skill |
| 12 | |
| 13 | - SDK connection failures, auth errors, or AMQP link errors |
| 14 | - Idle timeout, connection inactivity, or slow reconnection after disconnect |
| 15 | - AMQP link detach or detach-forced errors |
| 16 | - Message lock lost, message lock expired, lock renewal failures, or batch lock timeouts |
| 17 | - Session lock lost, session lock expired, or session receiver errors |
| 18 | - Event processor or message handler stops processing |
| 19 | - Duplicate events or checkpoint offset resets |
| 20 | - SDK configuration questions (retry, prefetch, batch size, receive batch behavior) |
| 21 | |
| 22 | ## MCP Tools |
| 23 | |
| 24 | | Tool | Command | Use | |
| 25 | |------|---------|-----| |
| 26 | | `mcp_azure_mcp_eventhubs` | Namespace/hub ops | List namespaces, hubs, consumer groups | |
| 27 | | `mcp_azure_mcp_servicebus` | Queue/topic ops | List namespaces, queues, topics, subscriptions | |
| 28 | | `mcp_azure_mcp_monitor` | `logs_query` | Query diagnostic logs with KQL | |
| 29 | | `mcp_azure_mcp_resourcehealth` | `get` | Check service health status | |
| 30 | | `mcp_azure_mcp_documentation` | Doc search | Search Microsoft Learn for troubleshooting docs | |
| 31 | |
| 32 | ## Diagnosis Workflow |
| 33 | |
| 34 | 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 |
| 35 | 2. **Check resource health** — Use `mcp_azure_mcp_resourcehealth` to verify the namespace is healthy |
| 36 | 3. **Review the error message** — Match against language-specific troubleshooting guide |
| 37 | 4. **Look up documentation** — Use `mcp_azure_mcp_documentation` to search Microsoft Learn for the error or topic |
| 38 | 5. **Check configuration** — Verify connection string, entity name, consumer group |
| 39 | 6. **Recommend fix** — Apply remediation, citing documentation found |
| 40 | |
| 41 | |
| 42 | ## Troubleshooting Guides |
| 43 | |
| 44 | Connectivity, SDK, and auth troubleshooting guides are located in the azure-diagnostics skill under `troubleshooting/messaging/`. |
| 45 | |
| 46 | ## References |
| 47 | |
| 48 | - Use `mcp_azure_mcp_documentation` to search Microsoft Learn for latest guidance. |