📦

azure-diagnostics

Name: azure-diagnostics
Author: microsoft

آمن

Déboguer les problèmes de production Azure

Cette compétence aide les développeurs à diagnostiquer et résoudre les problèmes de production dans Azure en fournissant des flux de débogage structurés, des commandes de diagnostic et des requêtes KQL pour Container Apps.

يدعم: Claude Codex Code(CC)

📊 69 كافٍ

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

رفع في Claude

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

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

اختبرها

استخدام "azure-diagnostics". Ma Container App affiche le statut 'Running' mais retourne des erreurs 502

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

Vérifiez que la configuration targetPort d'ingress correspond au port d'écoute de votre application
Vérifiez que le point de terminaison de santé retourne HTTP 200
Passez en revue les journaux de démarrage du conteneur pour des erreurs
Assurez-vous que EXPOSE du Dockerfile correspond à la configuration d'ingress

استخدام "azure-diagnostics". Écrire une requête KQL pour trouver les requêtes échouées

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

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.

الملفات التي تم فحصها

393

الأسطر التي تم تحليلها

النتائج

إجمالي عمليات التدقيق

مشكلات حرجة (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:3 SKILL.md:45 SKILL.md:78 references/kql-queries.md:19 references/kql-queries.md:30 references/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-120 references/azure-resource-graph.md:3-93 references/container-apps/README.md:7-105 references/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:62 references/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

درجة الجودة

الهندسة المعمارية

100

قابلية الصيانة

المحتوى

المجتمع

الأمان

الامتثال للمواصفات

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

Déboguer les échecs de pulling d'image de Container App

Diagnostiquer pourquoi une image de conteneur échoue à être tirée d'Azure Container Registry et obtenir les commandes de correction étape par étape

Analyser les journaux d'application avec KQL

Interroger Application Insights pour trouver les erreurs récentes, les requêtes échouées et les problèmes de performance lente

Résoudre les problèmes de timeout de démarrage à froid

Identifier et résoudre les problèmes de première requête lente dans Azure Container Apps en ajustant les paramètres de réplica

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

Demande de diagnostic de base

Mon Azure Container App ne démarre pas. Aidez-moi à diagnostiquer le problème en utilisant la compétence azure-diagnostics.

Dépannage des échecs de pulling d'image

J'ai des erreurs de pulling d'image constantes dans ma Container App. Comment résoudre les problèmes d'authentification ACR ?

Analyse des journaux avec KQL

Aidez-moi à écrire des requêtes KQL pour trouver les erreurs dans mes journaux Application Insights de la dernière heure.

Investigation des probes de santé

Mon conteneur redémarre constamment en raison d'échecs de probes de santé. Que dois-je vérifier ?

أفضل الممارسات

Commencez par les vérifications de santé des ressources avant d'approfondir les journaux détaillés
Utilisez un flux de diagnostic systématique : symptômes -> santé -> journaux -> métriques -> changements
Exploitez AppLens MCP pour l'analyse de cause racine alimentée par l'IA lorsqu'elle est disponible
Documentez toutes les étapes de correction tentées pour référence future

تجنب

Ne sautez pas les vérifications de santé lors de l'investigation des redémarrages de conteneurs
Ne supposez pas que le service Azure est en bonne santé sans vérifier HealthResources d'abord
Ne ignorez pas les échecs d'état de provisionnement - ceux-ci indiquent des problèmes de déploiement

الأسئلة المتكررة

Que fait réellement cette compétence ?

Cette compétence fournit des guides de dépannage, des commandes de diagnostic et des requêtes KQL pour Azure Container Apps. Elle n'exécute pas de commandes mais vous apprend à diagnostiquer les problèmes.

Cette compétence peut-elle résoudre mes problèmes Azure ?

Non. Cette compétence fournit des conseils et des commandes que vous pouvez exécuter. Vous devez vous-même exécuter les commandes Azure CLI avec vos identifiants Azure.

Quels services Azure sont pris en charge ?

Couvre actuellement les diagnostics Azure Container Apps, y compris le pulling d'image, le démarrage à froid et les problèmes de probes de santé. D'autres services à venir.

Dois-je avoir Azure CLI installé ?

Oui, vous devez avoir Azure CLI installé pour exécuter les commandes de diagnostic affichées. La compétence fournit les commandes mais vous devez avoir az CLI configuré.

Qu'est-ce que AppLens ?

AppLens est un outil MCP Azure qui fournit des diagnostics alimentés par l'IA. Il peut détecter automatiquement les problèmes et suggérer des étapes de correction.

Comment interroger Azure Resource Graph ?

Utilisez l'outil MCP extension_cli_generate avec l'intention 'query Azure Resource Graph' ou construisez des commandes az graph query avec KQL.