azure-messaging

作者： microsoft

排查并解决Event Hubs和Service Bus的Azure Messaging SDK问题。涵盖连接失败、身份验证错误、消息处理问题以及SDK配置问题。适用场景：事件中心SDK错误、服务总线SDK问题、消息传递连接失败、AMQP错误、事件处理器主机问题、消息锁丢失、消息锁过期、锁续订、批量锁续订、发送超时、接收器断开、SDK故障排除、azure messaging SDK、事件中心消费者、服务总线队列问题、主题订阅错误、启用事件中心日志记录、服务总线日志记录、eventhub python、servicebus java、eventhub javascript、servicebus dotnet、事件中心检查点、事件中心未接收消息、服务总线死信、批量处理锁、会话锁过期、空闲超时、连接不活跃、链接分离、慢速重连、会话错误、重复事件、偏移重置、接收批次。

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

下载 ZIP GitHub

3.1k

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

Identify the SDK and version — Check the prompt for SDK and version clues; if not stated, proceed with diagnosis and ask later if needed
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