skilld
All skills
microsoft avatar

/azure-messaging

@b3c238e
by microsoftmicrosoft/skills3.1k stars
351

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.

Ask your Agent

Use this Skill: https://skilld.dev/gh/microsoft/skills/azure-messaging

This session only. Nothing lands on disk.

SKILL.md

≈234 tokens always: the name and description. ≈564 when used: this file.

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.

Source: SKILL.md on GitHub

Third-party checks

No alerts15d3 checks · Risk SAFE
  • Gen Agent Trust Hub15d

    This skill is safe for use. It provides a troubleshooting framework for Azure Messaging services using platform-managed tools. No security concerns were identified.

  • Socket15d

    No alerts

  • Snyk15d

    Risk: LOW · No issues

Provenance

Signed by skilld at b3c238e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 19 hours ago.

Activeupdated 2 months ago

Capability

metadata
{
  "author": "Microsoft",
  "version": "1.2.1"
}

Topics

README badge

README badge for microsoft/skills/azure-messaging