azure-messaging
Résoudre les problèmes liés aux SDK Azure Messaging pour Event Hubs et Service Bus. Couvre les échecs de connexion, les erreurs d'authentification, les problèmes de traitement des messages et les problèmes de configuration du SDK. QUAND : erreur SDK Event Hub, problème SDK Service Bus, échec de connexion de messagerie, erreur AMQP, problème d'hôte de processeur d'événements, verrou de message perdu, verrou de message expiré, renouvellement de verrou, lot de renouvellement de verrou, délai d'envoi dépassé, récepteur déconnecté, dépannage SDK, SDK de messagerie Azure, consommateur Event Hub, problème de file d'attente Service Bus, erreur d'abonnement à une rubrique, activation de la journalisation Event Hub, journalisation Service Bus, eventhub python, servicebus java, eventhub javascript, servicebus dotnet, point de contrôle Event Hub, Event Hub ne recevant pas de messages, lettre morte Service Bus, verrou de traitement par lot, verrou de session expiré, délai d'inactivité, connexion inactive, détachement de lien, reconnexion lente, erreur de session, événements en double, réinitialisation de décalage, réception par lot.
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.