المهارات azure-diagnostics
📦

azure-diagnostics

آمن

Debug Azure 生產環境問題

此技能可透過結構化除錯工作流程、診斷命令和 Container Apps 的 KQL 查詢，協助開發人員診斷和排除 Azure 生產環境問題。

يدعم: Claude Codex Code(CC)
📊 69 كافٍ
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "azure-diagnostics". My Container App shows status 'Running' but returns 502 errors

النتيجة المتوقعة:

  • Check the ingress targetPort configuration matches your app's listening port
  • Verify the health endpoint returns HTTP 200
  • Review container startup logs for errors
  • Ensure Dockerfile EXPOSE matches ingress configuration

استخدام "azure-diagnostics". Write a KQL query to find failed requests

النتيجة المتوقعة:

  • AppRequests
  • | where Success == false
  • | where TimeGenerated > ago(1h)
  • | summarize count() by Name, ResultCode
  • | order by count_ desc

التدقيق الأمني

آمن
v1 • 2/20/2026

This skill contains only documentation with example Azure CLI commands and KQL queries. Static scanner flagged 70 instances of 'external_commands' but these are markdown code blocks showing example commands, not executable code. Network findings are documentation URLs. Env access findings reference standard Azure Container Apps environment variables. All high/critical findings are false positives - the skill is safe for publication.

4
الملفات التي تم فحصها
393
الأسطر التي تم تحليلها
5
النتائج
1
إجمالي عمليات التدقيق

مشكلات حرجة (1)

multiple:1
False Positive: Dangerous Combination Heuristic
Scanner flagged 'Code execution + Network + Credential access' pattern. This is a documentation skill with no executable code. The 'external_commands' findings are Azure CLI examples in markdown code blocks. Network findings are documentation URLs. No credential access exists.

مشكلات عالية المخاطر (1)

SKILL.md:3SKILL.md:45SKILL.md:78references/kql-queries.md:19references/kql-queries.md:30references/kql-queries.md:41
False Positive: Weak Cryptographic Algorithm
Scanner flagged 'Weak cryptographic algorithm' in KQL query files. This is a false positive - the scanner misinterprets KQL keywords like 'where', 'state' as cryptographic terms. These are Kusto Query Language queries for log analysis.
مشكلات متوسطة المخاطر (3)
SKILL.md:57-120references/azure-resource-graph.md:3-93references/container-apps/README.md:7-105references/kql-queries.md:14-60
False Positive: External Commands in Documentation
Scanner flagged 70 instances of 'Ruby/shell backtick execution'. These are Azure CLI commands shown in markdown code blocks as documentation examples. The skill is a documentation reference - it shows users example commands but does not execute them.
references/container-apps/README.md:62references/kql-queries.md:64-65
False Positive: Hardcoded URLs
Scanner flagged 3 hardcoded URLs. These are legitimate Microsoft Learn documentation links and example curl commands for health check endpoints.
references/container-apps/README.md:81
False Positive: Environment Variable Access
Scanner flagged 'process.env.PORT' as sensitive. This is standard Azure Container Apps documentation showing how to read the container port from environment variables.
تم تدقيقه بواسطة: claude

درجة الجودة

50
الهندسة المعمارية
100
قابلية الصيانة
85
المحتوى
50
المجتمع
60
الأمان
91
الامتثال للمواصفات

ماذا يمكنك بناءه

Debug Container App 映像擷取失敗

診斷容器映像無法從 Azure Container Registry 擷取的原因，並取得逐步修復命令

使用 KQL 分析應用程式記錄

查詢 Application Insights 以找出近期的錯誤、失敗要求和效能緩慢問題

修復冷啟動逾時問題

透過調整複本設定，找出並解決 Azure Container Apps 中第一個要求緩慢的問題

جرّب هذه الموجهات

基本診斷要求 
我的 Azure Container App 啟動失敗。請使用 azure-diagnostics 技能協助我診斷問題。
映像擷取失敗疑難排解 
我的 Container App 持續發生映像擷取錯誤。如何修正 ACR 驗證問題？
使用 KQL 分析記錄 
協助我撰寫 KQL 查詢，以找出過去一小時內 Application Insights 記錄中的錯誤。
健康探測調查 
 
 
أفضل الممارسات
 
  •  在深入查看詳細記錄之前，先從資源健康檢查開始
  •  使用系統化診斷流程：症狀 -> 健康 -> 記錄 -> 度量 -> 變更
  •  在可用時利用 AppLens MCP 進行 AI 驅動的根本原因分析
  •  記錄所有嘗試的補救步驟以供日後參考
 
 
تجنب
 
  •  調查容器重新啟動時不要跳過健康檢查
  •  不要未經檢查 HealthResources 就假設 Azure 服務健康狀態
  •  不要忽視佈建狀態失敗 - 這些表示部署問題
 
 
الأسئلة المتكررة
 
這個技能實際上做什麼？  
此技能提供 Azure Container Apps 的疑難排解指南、診斷命令和 KQL 查詢。它不會執行命令，而是教您如何診斷問題。
這個技能可以修復我的 Azure 問題嗎？  
不行。此技能提供您可以執行的指導和命令。您必須使用 Azure 認證自行執行 Azure CLI 命令。
支援哪些 Azure 服務？  
目前涵蓋 Azure Container Apps 診斷，包括映像擷取、冷啟動和健康探測問題。更多服務即將推出。
需要安裝 Azure CLI 嗎？  
是的，您需要安裝 Azure CLI 來執行顯示的診斷命令。此技能提供命令，但您必須設定 az CLI。
什麼是 AppLens？  
AppLens 是 Azure MCP 工具，提供 AI 驅動的診斷。它可以自動偵測問題並建議補救步驟。
如何查詢 Azure Resource Graph？  
使用 intent 為 'query Azure Resource Graph' 的 extension_cli_generate MCP 工具，或使用 KQL 建構 az graph 查詢命令。
 
 
تفاصيل المطور
 
المؤلف
 microsoft
 
الترخيص
 
MIT
 
المستودع
 https://github.com/microsoft/github-copilot-for-azure/tree/main/plugin/skills/azure-diagnostics/
 
مرجع
 
main
 
بنية الملفات
 
📁 references/
 
📁 container-apps/
 
📄 README.md
 
📄 azure-resource-graph.md
 
📄 kql-queries.md
 
📄 SKILL.md