azure-messaging

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

Quality

73%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.github/skills/azure-messaging/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
Message lock lost, session lock, or send/receive timeouts
Event processor or message handler stops processing
SDK configuration questions (retry, prefetch, batch size)

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

Identify the SDK and version — Ask which language SDK and version the user is on
Check resource health — Use mcp_azure_mcp_resourcehealth to verify the namespace is healthy
Review the error message — Match against language-specific troubleshooting guide
Look up documentation — Use mcp_azure_mcp_documentation to search Microsoft Learn for the error or topic
Check configuration — Verify connection string, entity name, consumer group
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

Event Hubs: Python | Java | JS | .NET
Service Bus: Python | Java | JS | .NET

References

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

Reference Index

Load these on demand — do NOT read all at once:

Reference	When to Load
`references/auth-best-practices.md`	Auth Best Practices
`references/service-troubleshooting.md`	Service Troubleshooting

Repository: jonathan-vella/azure-agentic-infraops
Commit: ec7b8ff

Last updated: 7 days ago
Created: 7 days ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.