azure-diagnostics

Azure Diagnostics

權威指引 — 強制遵循

本文件為偵錯與疑難排解 Azure 生產問題的官方來源。請依照這些指示，系統性地診斷並解決常見的 Azure 服務問題。

觸發條件

當使用者想要以下操作時，啟動此技能：

• 偵錯或疑難排解生產問題
• 診斷 Azure 服務中的錯誤
• 分析應用程式記錄或計量
• 修正映像拉取、冷啟動或健康狀態探查問題
• 調查 Azure 資源為何失敗
• 尋找應用程式錯誤的根本原因
• 疑難排解 App Service 問題（高 CPU、部署失敗、當機、回應緩慢、TLS/自訂網域）
• 回應類似「疑難排解 App Service」、「App Service 高 CPU」或「App Service 部署失敗」的提示
• 疑難排解 Azure Function Apps（叫用失敗、逾時、繫結錯誤）
• 尋找與 Function App 連結的 App Insights 或 Log Analytics 工作區
• 疑難排解 AKS 叢集、節點、Pod、Ingress 或 Kubernetes 網路問題
• 疑難排解 Azure Messaging SDK 問題（Event Hubs、Service Bus 連線失敗、AMQP 錯誤、訊息鎖定問題）

規則

1. 從系統性診斷流程開始
2. 可用時使用 AppLens (MCP) 進行 AI 驅動診斷
3. 在深入記錄前先檢查資源健康狀態
4. 根據服務類型選擇適當的疑難排解指南
5. 記錄發現與嘗試的補救步驟
6. 將 AKS 事件導向專屬的 AKS 疑難排解文件

---

快速診斷流程

1. 識別症狀 - 什麼失敗了？
2. 檢查資源健康狀態 - Azure 是否健康？
3. 檢閱記錄 - 記錄顯示什麼？
4. 分析計量 - 效能模式？
5. 調查近期變更 - 什麼變更了？

---

各服務疑難排解指南

服務	常見問題	參考文件
Container Apps	映像拉取失敗、冷啟動、健康狀態探查、連接埠不符	container-apps/
App Service	高 CPU、部署失敗、當機、回應緩慢、TLS/自訂網域	app-service/
Function Apps	應用程式詳細資料、叫用失敗、逾時、繫結錯誤、冷啟動、遺失應用程式設定	functions/
AKS	叢集存取、節點、kube-system、排程、Crash Loop、Ingress、DNS、升級	AKS Troubleshooting
Messaging	Event Hubs 與 Service Bus SDK 錯誤、AMQP 失敗、訊息鎖定、連線能力	Messaging Troubleshooting

---

路由

• 將 Container Apps 和 Function Apps 的診斷保留在此上層技能中。
• 將進行中的 AKS 事件、AKS 特定資訊收集、證據收集與補救指引導向 AKS Troubleshooting。
• 將 Azure Messaging SDK 疑難排解（Event Hubs、Service Bus）導向 Messaging Troubleshooting。

---

快速參考

常用診斷命令

# 檢查資源健康狀態
az resource show --ids RESOURCE_ID
# 檢視活動記錄
az monitor activity-log list -g RG --max-events 20
# Container Apps 記錄
az containerapp logs show --name APP -g RG --follow
# Function App 記錄（查詢 App Insights 追蹤）
az monitor app-insights query --apps APP-INSIGHTS -g RG \
  --analytics-query "traces | where timestamp > ago(1h) | order by timestamp desc | take 50"

AppLens (MCP 工具)

如需 AI 驅動診斷，請使用：

mcp_azure_mcp_applens
  intent: "diagnose issues with <resource-name>"
  command: "diagnose"
  parameters:
    resourceId: "<resource-id>"

提供：
- 自動化問題偵測
- 根本原因分析
- 補救建議

Azure Monitor (MCP 工具)

如需查詢記錄與計量：

mcp_azure_mcp_monitor
  intent: "query logs for <resource-name>"
  command: "logs_query"
  parameters:
    workspaceId: "<workspace-id>"
    query: "<KQL-query>"

常見診斷查詢請參閱 kql-queries.md。

---

檢查 Azure 資源健康狀態

使用 MCP

mcp_azure_mcp_resourcehealth
  intent: "check health status of <resource-name>"
  command: "get"
  parameters:
    resourceId: "<resource-id>"

使用 CLI

# 檢查特定資源健康狀態
az resource show --ids RESOURCE_ID

# 檢查近期活動
az monitor activity-log list -g RG --max-events 20

---

參考資料

• KQL 查詢庫
• Azure Resource Graph 查詢
• App Service 疑難排解
• Function Apps 疑難排解
• Messaging 疑難排解