azure-messaging

bởi microsoft

Chẩn đoán và giải quyết các sự cố SDK Azure Event Hubs và Service Bus với quy trình xử lý sự cố có cấu trúc. Bao gồm lỗi kết nối, lỗi xác thực, sự cố liên kết AMQP, hết thời gian chờ khóa tin nhắn và sự cố ngừng xử lý sự kiện trên các SDK Python, Java, JavaScript và .NET. Cung cấp hướng dẫn xử lý sự cố dành riêng cho từng ngôn ngữ cho Event Hubs và Service Bus, cùng với chẩn đoán kết nối cho cổng, dự phòng WebSocket, tường lửa IP và điểm cuối riêng. Cung cấp các công cụ MCP để truy vấn tài nguyên...

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

Tải ZIP GitHub

1.4k

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