Cloudofficial

azure-messaging

microsoft/GitHub-Copilot-for-Azure · updated Apr 8, 2026

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

Diagnose and resolve Azure Event Hubs and Service Bus SDK issues across languages.

  • 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, configuration best practices (retry, prefetch, batch size), and checkpoint/dead-letter diagnostics
  • Integrates with Azure Monitor for KQL log queries, resource health checks, and Microsoft
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.