azure-messaging

Diagnose and resolve Azure Event Hubs and Service Bus SDK connection, authentication, and message processing errors.

Updated Jan 23, 2026
One-click install
npx skills add https://github.com/stephschofield/beth --skill azure-messaging-stephschofield
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: azure-messaging
Source: https://github.com/stephschofield/beth/tree/main/.github/skills/azure-messaging
Command: npx skills add https://github.com/stephschofield/beth --skill azure-messaging-stephschofield

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Azure Event Hubs and Service Bus applications fail in production with cryptic AMQP errors, lock losses, connection drops, and authentication failures that are hard to diagnose without deep SDK knowledge. This Skill provides structured troubleshooting workflows and language-specific error references to identify root causes and apply the correct fix. ## Core Features & Use Cases - Guided Diagnosis Workflow: A six-step process that identifies the SDK and version, checks resource health via Azure MCP tools, matches errors against troubleshooting guides, and recommends documented fixes. - Language-Specific SDK Guides: Detailed error tables, logging configuration, and retry settings for Event Hubs and Service Bus across .NET, Java, JavaScript, and Python. - Service-Level Troubleshooting: Covers connectivity issues including firewall ports, WebSocket fallback, IP allowlists, private endpoints, and transient network failures. - Use Case: A developer sees MessageLockLost errors in a Python Service Bus consumer. The Skill matches the error to the Python guide, explains that processing exceeded the lock duration, and provides the AutoLockRenewer code pattern to fix it. ## Quick Start Ask the agent to troubleshoot your Azure messaging error, for example: my Event Hubs consumer keeps getting disconnected with a ConsumerDisconnected exception, help me diagnose it.

Frequently Asked Questions about azure-messaging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot Azure Event Hubs connection failures?▼

First verify the connection string from the Azure portal, then check that AMQP ports 5671 and 5672 plus HTTPS 443 are open. If ports are blocked, configure WebSocket fallback to connect over port 443, and check IP firewall rules on the namespace.

How to fix MessageLockLost errors in Azure Service Bus?▼

MessageLockLost occurs when processing exceeds the lock duration or the AMQP link detaches. Reduce per-message processing time, use AutoLockRenewer in Python or auto-lock renewal in other SDKs, and check for transient network issues.

How do I enable logging for Azure messaging SDKs?▼

Python uses the logging module on azure.eventhub or azure.servicebus loggers with logging_enable=True. JavaScript sets AZURE_LOG_LEVEL=verbose or DEBUG=azure*,rhea*. Java configures SLF4J loggers for com.azure.messaging packages.

Should I use DefaultAzureCredential in production for Event Hubs?▼

No. DefaultAzureCredential is intended for local development only because its fallback chain adds latency and unpredictable behavior. Use ManagedIdentityCredential in production with RBAC roles like Azure Event Hubs Data Sender or Receiver.

Why does my Event Hubs consumer keep getting disconnected?▼

ConsumerDisconnected errors are expected during load balancing when a higher-priority consumer takes partition ownership. If disconnections persist for more than five minutes without scaling activity, investigate partition count relative to CPU cores.

When should I not use this troubleshooting skill?▼

Do not use it for creating Event Hubs or Service Bus resources, which belongs to provisioning workflows, or for cost analysis. It focuses strictly on diagnosing SDK-level connection, authentication, and message processing issues.