azure-messaging
Soluciona problemas y resuelve incidencias con los SDK de Azure Messaging para Event Hubs y Service Bus. Cubre fallos de conexión, errores de autenticación, problemas de procesamiento de mensajes y problemas de configuración del SDK. CUÁNDO: error del SDK de event hub, problema del SDK de service bus, fallo de conexión de mensajería, error AMQP, problema del host del procesador de eventos, bloqueo de mensaje perdido, bloqueo de mensaje caducado, renovación de bloqueo, renovación de bloqueo por lotes, tiempo de espera de envío, receptor desconectado, solución de problemas del SDK, SDK de mensajería de Azure, consumidor de event hub, problema de cola de service bus, error de suscripción a tema, habilitar registro de event hub, registro de service bus, eventhub python, servicebus java, eventhub javascript, servicebus dotnet, punto de control de event hub, event hub no recibe mensajes, carta muerta de service bus, bloqueo de procesamiento por lotes, bloqueo de sesión caducado, tiempo de espera inactivo, conexión inactiva, desvinculación de enlace, reconexión lenta, error de sesión, eventos duplicados, restablecimiento de desplazamiento, recibir 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.