azure-messaging
Solucione problemas e resolva questões com os SDKs de Mensageria do Azure para Event Hubs e Service Bus. Abrange falhas de conexão, erros de autenticação, problemas de processamento de mensagens e problemas de configuração do SDK. QUANDO: erro de SDK do event hub, problema de SDK do service bus, falha de conexão de mensageria, erro AMQP, problema de host do processador de eventos, bloqueio de mensagem perdido, bloqueio de mensagem expirado, renovação de bloqueio, renovação de bloqueio em lote, tempo limite de envio, receptor desconectado, solução de problemas de SDK, SDK de mensageria do Azure, consumidor de event hub, problema de fila do service bus, erro de assinatura de tópico, habilitar registro de event hub, registro do service bus, eventhub python, servicebus java, eventhub javascript, servicebus dotnet, checkpoint de event hub, event hub não recebendo mensagens, dead letter do service bus, bloqueio de processamento em lote, bloqueio de sessão expirado, tempo limite ocioso, conexão inativa, desanexação de link, reconexão lenta, erro de sessão, eventos duplicados, redefinição de deslocamento, receber lote.
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.