mcpField
A
azure-messaging

azure-messaging

Official
github.com/microsoftSecurity1.6k560.1k installsUpdated today
Repository

About azure-messaging

Azure Messaging SDK Troubleshooting is a skill for diagnosing issues in Azure Event Hubs and Azure Service Bus SDKs. It is aimed at developers facing connection, auth, AMQP link or message processing errors, and follows a fixed diagnosis workflow.

Key features

  1. 01Diagnoses SDK connection, auth and AMQP link errors
  2. 02Handles message and session lock loss or expiry
  3. 03Troubleshoots stopped event processors and duplicate events
  4. 04Checks resource health and searches Microsoft Learn

Use cases

  1. 01Investigating Event Hubs idle timeouts and slow reconnection
  2. 02Resolving Service Bus message lock renewal failures
  3. 03Locating checkpoint offset resets in event processors

MCP support

The skill directs the use of Azure MCP tools such as mcp_azure_mcp_eventhubs, mcp_azure_mcp_servicebus and mcp_azure_mcp_monitor to list namespaces, queues, logs and health status.

Install

Copy the command and run it in a terminal.

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

After installing, type/azure-messagingin Claude Code to confirm it loaded.

Details

From the project README

Azure Messaging SDK Troubleshooting

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.

Comments

Markdown supported