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 the actual diagnosis steps Microsoft support would use. It checks service health first, matches your error against language-specific troubleshooting guides, then searches Microsoft Learn for the exact fix. The workflow is solid: identify SDK version, verify namespace health, decode the error message, find official docs, check your connection config, apply the remedy. It covers the gnarly stuff like session lock expiration, duplicate events, and checkpoint offset resets that can make messaging SDKs frustrating to debug.

install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.: 5
skills.sh installs: 649.3K
GitHub stars: 1.6K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add microsoft/azure-skills --skill azure-messaging --agent claude-code

Installs into .claude/skills of the current project.

Files

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)