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

azure-diagnostics

آمن

调试 Azure 生产问题

此技能通过提供结构化的调试工作流、诊断命令和 Container Apps 的 KQL 查询，帮助开发者诊断和排查 Azure 生产问题。

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

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

2

رفع في Claude

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

3

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

اختبرها

استخدام "azure-diagnostics". 我的 Container App 显示状态为“Running”但返回 502 错误

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

  • 检查入口 targetPort 配置是否与应用监听的端口匹配
  • 验证健康端点返回 HTTP 200
  • 查看容器启动日志中的错误
  • 确保 Dockerfile EXPOSE 与入口配置一致

استخدام "azure-diagnostics". 编写 KQL 查询以查找失败请求

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

  • 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
الامتثال للمواصفات

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

调试 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