SkillsSKILLS
Cloud

azure-messaging▌

microsoft/azure-skills · updated Apr 8, 2026

$npx skills add https://github.com/microsoft/azure-skills --skill azure-messaging
summary

Diagnose and resolve Azure Event Hubs and Service Bus SDK issues with structured troubleshooting workflows.

  • ›Covers connection failures, authentication errors, AMQP link issues, message lock timeouts, and event processor stalls across Python, Java, JavaScript, and .NET SDKs
  • ›Includes language-specific troubleshooting guides for Event Hubs and Service Bus, plus connectivity diagnostics for ports, WebSocket fallback, IP firewalls, and private endpoints
  • ›Provides MCP tools to query resourc
skill.md

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 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

Connectivity Troubleshooting

See Service Troubleshooting Guide for ports, WebSocket fallback, IP firewall, private endpoints, and service tags.

SDK Troubleshooting Guides

References

Use mcp_azure_mcp_documentation to search Microsoft Learn for latest guidance. See Service Troubleshooting Guide for network and service-level docs.