Back to skills

Agent Skill

Azure Messaging

azure-messaging

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.

MicrosoftBackendPythonAgent-skills
github.com/microsoft/azure-skills/tree/main/skills/azure-messaging

398K installs

•

microsoft/azure-skills

•

by Microsoft

Score

8.5

/ 10

Installs

398K

Repo Stars

1.2K

Last Updated

0d ago

Fresh

Quality Ratio

99%

Description

Verified

Language

Python

First Published

Feb 2026

Summary

The Azure Messaging agent skill specifically guides developers through diagnosing and resolving common issues encountered when using Azure Event Hubs and Service Bus SDKs, such as connection failures, authentication errors, and message processing problems. This agent skill benefits developers, SREs, and support engineers working with applications that integrate Azure's core messaging services. This is a niche skill with a smaller but dedicated user base. It instructs the AI agent to systematically identify the problematic SDK and version, check resource health using tools like `mcp_azure_mcp_resourcehealth`, and review error messages against documentation available via `mcp_azure_mcp_documentation`. It further assists in diagnosing issues like message lock loss or send timeouts, and provides guidance on configuring SDK properties such as retry policies or batch sizes. This agent skill is narrowly focused on troubleshooting SDK issues and is not intended for creating resources, monitoring metrics, or cost analysis.

Skill Definition

Quick Reference

PropertyValue
ServicesAzure Event Hubs, Azure Service Bus
MCP Toolsmcp_azure_mcp_eventhubs, mcp_azure_mcp_servicebus
Best ForDiagnosing 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

ToolCommandUse
mcp_azure_mcp_eventhubsNamespace/hub opsList namespaces, hubs, consumer groups
mcp_azure_mcp_servicebusQueue/topic opsList namespaces, queues, topics, subscriptions
mcp_azure_mcp_monitorlogs_queryQuery diagnostic logs with KQL
mcp_azure_mcp_resourcehealthgetCheck service health status
mcp_azure_mcp_documentationDoc searchSearch 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 needed
  2. Check resource health — Use mcp_azure_mcp_resourcehealth to verify the namespace is healthy
  3. Review the error message — Match against language-specific troubleshooting guide
  4. Look up documentation — Use mcp_azure_mcp_documentation to search Microsoft Learn for the error or topic
  5. Check configuration — Verify connection string, entity name, consumer group
  6. Recommend fix — Apply remediation, citing documentation found

Troubleshooting Guides

Connectivity, SDK, and auth troubleshooting guides are located in the azure-diagnostics skill under troubleshooting/messaging/.

References

  • Use mcp_azure_mcp_documentation to search Microsoft Learn for latest guidance.

How to Use

Use in O-mega

Claude Code

npx skills add microsoft/azure-skills azure-messaging