PluginWorld
Az

azure-messaging

Skills✓ SPEC VERIFIED✓ OWNER

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 pr

@microsoft · MIT · updated yesterday

SECURITY

A+

SCORE

90

INSTALLS

▲ 603.3K

PLUG IN

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

Works with Claude Code, Cursor, Codex and 20+ agents

README

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

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.

SIMILAR PLUGINS