azure-messaging

作者: microsoft

使用結構化疑難排解工作流程,診斷並解決 Azure Event Hubs 與 Service Bus SDK 問題。涵蓋 Python、Java、JavaScript 及 .NET SDK 中的連線失敗、驗證錯誤、AMQP 連結問題、訊息鎖定逾時及事件處理器停滯。包含適用於 Event Hubs 與 Service Bus 的語言特定疑難排解指南,以及連接埠、WebSocket 後援、IP 防火牆與私人端點的連線診斷。提供 MCP 工具以查詢資源...

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

Azure Messaging SDK Troubleshooting

Quick Reference

PropertyValue
ServicesAzure Event Hubs, Azure Service Bus
MCP Toolsmcp_azure_mcp_eventhubs, mcp_azure_mcp_servicebus
Best ForDiagnosing 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

ToolCommandUse
mcp_azure_mcp_eventhubsNamespace/hub opsList namespaces, hubs, consumer groups
mcp_azure_mcp_servicebusQueue/topic opsList namespaces, queues, topics, subscriptions
mcp_azure_mcp_monitorlogs_queryQuery diagnostic logs with KQL
mcp_azure_mcp_resourcehealthgetCheck service health status
mcp_azure_mcp_documentationDoc searchSearch Microsoft Learn for troubleshooting docs

Diagnosis Workflow

  1. Identify the SDK and version — Check the prompt for SDK and version clues; if not stated, proceed with diagnosis and ask later if needed
  2. Check resource health — Use mcp_azure_mcp_resourcehealth to verify the namespace is healthy
  3. Review the error message — Match against language-specific troubleshooting guide
  4. Look up documentation — Use mcp_azure_mcp_documentation to search Microsoft Learn for the error or topic
  5. Check configuration — Verify connection string, entity name, consumer group
  6. 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_documentation to search Microsoft Learn for latest guidance.

來自 microsoft 的更多技能

oss-growth
microsoft
開源增長駭客角色
agent-framework-azure-ai-py
microsoft
使用Microsoft Agent Framework Python SDK(agent-framework-azure-ai)构建Azure AI Foundry代理。适用于使用AzureAIAgentsProvider创建持久化代理、使用托管工具(代码解释器、文件搜索、网络搜索)、集成MCP服务器、管理对话线程或实现流式响应。涵盖函数工具、结构化输出和多工具代理。
development
airunway-aks-setup
microsoft
在AKS上設定AI Runway——從裸叢集到執行模型。涵蓋叢集驗證、控制器安裝、GPU評估、供應商設定及首次部署。時機:「設定AI Runway」、「上線AKS叢集」、「安裝AI Runway」、「airunway設定」、「部署模型至AKS」、「在AKS上進行GPU推論」、「在AKS上設定KAITO」、「在AKS上執行LLM」、「在AKS上使用vLLM」、「在AKS上設定模型服務」、「AI Runway控制器」。
devops
appinsights-instrumentation
microsoft
使用Azure Application Insights檢測Web應用程式的指南。提供遙測模式、SDK設定與組態參考。適用時機:如何檢測應用程式、App Insights SDK、遙測模式、什麼是App Insights、Application Insights指南、檢測範例、APM最佳實踐。
devops
applicationinsights-web-ts
microsoft
使用Application Insights JavaScript SDK(@microsoft/applicationinsights-web)為瀏覽器/Web應用程式進行檢測。適用於真實使用者監控(RUM)——頁面檢視、點擊、AJAX/fetch依賴、例外、自訂事件,以及與後端OpenTelemetry追蹤關聯的瀏覽器端GenAI代理追蹤。涵蓋SDK載入器指令碼與npm設定、框架擴充(React、React Native、Angular)、點擊分析、遙測初始化器,以及從瀏覽器發出的代理/工具/模型span的OTel GenAI語意慣例。
devops
azure-ai-anomalydetector-java
microsoft
使用適用於 Java 的 Azure AI 異常偵測器 SDK 建置異常偵測應用程式。在實作單變量/多變量異常偵測、時間序列分析或 AI 驅動監控時使用。
development
azure-ai-language-conversations-py
microsoft
使用 azure-ai-language-conversations Python SDK 實作對話語言理解(CLU)。當使用 ConversationAnalysisClient 分析對話意圖與實體、建置 NLP 功能,或將語言理解整合至應用程式時使用。
development
azure-ai-ml-py
microsoft
Azure Machine Learning SDK v2 for Python。用於機器學習工作區、作業、模型、資料集、計算資源與管線。 觸發詞:「azure-ai-ml」、「MLClient」、「workspace」、「model registry」、「training jobs」、「datasets」。
development