azure-messaging
작성자: microsoft
Azure Messaging SDK(Event Hubs 및 Service Bus용)의 문제를 해결하고 해결합니다. 연결 실패, 인증 오류, 메시지 처리 문제, SDK 구성 문제를 다룹니다. 적용 시점: 이벤트 허브 SDK 오류, 서비스 버스 SDK 문제, 메시징 연결 실패, AMQP 오류, 이벤트 프로세서 호스트 문제, 메시지 잠금 손실, 메시지 잠금 만료, 잠금 갱신, 잠금 갱신 배치, 전송 시간 초과, 수신기 연결 끊김, SDK 문제 해결, Azure 메시징 SDK, 이벤트 허브 소비자, 서비스 버스 큐 문제, 토픽 구독 오류, 이벤트 허브 로깅 활성화, 서비스 버스 로깅, eventhub python, servicebus java, eventhub javascript, servicebus dotnet, 이벤트 허브 체크포인트, 이벤트 허브 메시지 미수신, 서비스 버스 데드 레터, 배치 처리 잠금, 세션 잠금 만료, 유휴 시간 초과, 연결 비활성, 링크 분리, 느린 재연결, 세션 오류, 중복 이벤트, 오프셋 재설정, 배치 수신.
npx skills add https://github.com/microsoft/skills --skill azure-messagingAzure 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_resourcehealthto verify the namespace is healthy - Review the error message — Match against language-specific troubleshooting guide
- Look up documentation — Use
mcp_azure_mcp_documentationto search Microsoft Learn for the error or topic - Check configuration — Verify connection string, entity name, consumer group
- 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_documentationto search Microsoft Learn for latest guidance.