PaperclipOrg
Claude Agent Skill · by Microsoft

Azure Messaging

When your Azure Event Hubs or Service Bus SDK starts throwing AMQP errors, connection timeouts, or mysterious message lock issues, this skill walks you through

Install
Terminal · npx
$npx skills add https://github.com/obra/superpowers --skill test-driven-development
Works with Paperclip

How Azure Messaging fits into a Paperclip company.

Azure Messaging drops into any Paperclip agent that handles this kind of work. Assign it to a specialist inside a pre-configured PaperclipOrg company and the skill becomes available on every heartbeat — no prompt engineering, no tool wiring.

S
SaaS FactoryPaired

Pre-configured AI company — 18 agents, 18 skills, one-time purchase.

$27$59
Explore pack
Source file
SKILL.md62 lines
Expand
---name: azure-messagingdescription: "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 processor host issue, message lock lost, message lock expired, lock renewal, lock renewal batch, send timeout, receiver disconnected, SDK troubleshooting, azure messaging SDK, event hub consumer, service bus queue issue, topic subscription error, enable logging event hub, service bus logging, eventhub python, servicebus java, eventhub javascript, servicebus dotnet, event hub checkpoint, event hub not receiving messages, service bus dead letter, batch processing lock, session lock expired, idle timeout, connection inactive, link detach, slow reconnect, session error, duplicate events, offset reset, receive batch."license: MITmetadata:  author: Microsoft  version: "1.0.4"--- # 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 needed2. **Check resource health** — Use `mcp_azure_mcp_resourcehealth` to verify the namespace is healthy3. **Review the error message** — Match against language-specific troubleshooting guide4. **Look up documentation** — Use `mcp_azure_mcp_documentation` to search Microsoft Learn for the error or topic5. **Check configuration** — Verify connection string, entity name, consumer group6. **Recommend fix** — Apply remediation, citing documentation found  ## Connectivity Troubleshooting See [Service Troubleshooting Guide](references/service-troubleshooting.md) for ports, WebSocket fallback, IP firewall, private endpoints, and service tags. ## SDK Troubleshooting Guides - **Event Hubs**: [Python](references/sdk/azure-eventhubs-py.md) | [Java](references/sdk/azure-eventhubs-java.md) | [JS](references/sdk/azure-eventhubs-js.md) | [.NET](references/sdk/azure-eventhubs-dotnet.md)- **Service Bus**: [Python](references/sdk/azure-servicebus-py.md) | [Java](references/sdk/azure-servicebus-java.md) | [JS](references/sdk/azure-servicebus-js.md) | [.NET](references/sdk/azure-servicebus-dotnet.md) ## References Use `mcp_azure_mcp_documentation` to search Microsoft Learn for latest guidance. See [Service Troubleshooting Guide](references/service-troubleshooting.md) for network and service-level docs.