1---2name: azure-messaging3description: Troubleshoot and resolve issues with the Azure Messaging SDKs for Event Hubs and Service Bus, covering connection failures, authentication errors, message processing problems, and SDK configuration. Use when the user hits an Event Hubs or Service Bus SDK error, AMQP or connection failure, event processor host issue, lost or expired message lock, lock renewal problem, send timeout, disconnected receiver, checkpoint or offset issue, dead-letter or session error, duplicate events, or needs SDK logging enabled in .NET, Java, Python, or JavaScript.4license: MIT5---67<!-- Generated from harness/github-copilot/skills/azure-messaging/SKILL.md by harness/claude-code/scripts/convert_from_copilot.py. Edit the source, not this file. -->89# Azure Messaging SDK Troubleshooting1011## Quick Reference1213| Property | Value |14|----------|-------|15| **Services** | Azure Event Hubs, Azure Service Bus |16| **MCP Tools** | `mcp_azure_mcp_eventhubs`, `mcp_azure_mcp_servicebus` |17| **Best For** | Diagnosing SDK connection, auth, and message processing issues |1819## When to invoke2021- SDK connection failures, auth errors, or AMQP link errors22- Idle timeout, connection inactivity, or slow reconnection after disconnect23- AMQP link detach or detach-forced errors24- Message lock lost, message lock expired, lock renewal failures, or batch lock timeouts25- Session lock lost, session lock expired, or session receiver errors26- Event processor or message handler stops processing27- Duplicate events or checkpoint offset resets28- SDK configuration questions (retry, prefetch, batch size, receive batch behavior)2930## MCP Tools3132| Tool | Command | Use |33|------|---------|-----|34| `mcp_azure_mcp_eventhubs` | Namespace/hub ops | List namespaces, hubs, consumer groups |35| `mcp_azure_mcp_servicebus` | Queue/topic ops | List namespaces, queues, topics, subscriptions |36| `mcp_azure_mcp_monitor` | `logs_query` | Query diagnostic logs with KQL |37| `mcp_azure_mcp_resourcehealth` | `get` | Check service health status |38| `mcp_azure_mcp_documentation` | Doc search | Search Microsoft Learn for troubleshooting docs |3940## Diagnosis Workflow41421. **Identify the SDK and version** — Check the prompt for SDK and version clues; if not stated, proceed with diagnosis and ask later if needed432. **Check resource health** — Use `mcp_azure_mcp_resourcehealth` to verify the namespace is healthy443. **Review the error message** — Match against language-specific troubleshooting guide454. **Look up documentation** — Use `mcp_azure_mcp_documentation` to search Microsoft Learn for the error or topic465. **Check configuration** — Verify connection string, entity name, consumer group476. **Recommend fix** — Apply remediation, citing documentation found484950## Troubleshooting Guides5152Connectivity, SDK, and auth troubleshooting guides are located in the azure-diagnostics skill under `troubleshooting/messaging/`.5354## References5556- Use `mcp_azure_mcp_documentation` to search Microsoft Learn for latest guidance.5758## Output template5960```markdown61## Messaging troubleshooting result6263**Status:** resolved | mitigated | inconclusive64**Summary:** <one sentence covering scope and outcome>6566### Details67Error signature, root cause, and the SDK or configuration fix.6869### Validation70- <check performed>: <result and evidence>71```7273## Quality gate7475- [ ] The diagnosis matches the observed SDK error and client version.76- [ ] The fix names the specific SDK setting or code change.77- [ ] The output follows `## Output template` exactly.78- [ ] Every reported check was performed and its evidence is shown.79- [ ] Irreversible Azure actions were confirmed with the user first.