スキル azure-diagnostics
📦

azure-diagnostics

安全

Azure本番環境の問題をデバッグ

このスキルは、Azure Container Appsの構造化されたデバッグワークフロー、診断コマンド、KQLクエリを提供することで、開発者がAzure本番環境の問題を診断・トラブルシューティングするのに役立ちます。

対応: Claude Codex Code(CC)
📊 69 十分
1

スキルZIPをダウンロード

2

Claudeでアップロード

設定 → 機能 → スキル → スキルをアップロードへ移動

3

オンにして利用開始

テストする

「azure-diagnostics」を使用しています。 Container Appのステータスは「Running」ですが、502エラーが返されます

期待される結果:

  • ingressのtargetPort設定がアプリのリスニングポートと一致しているか確認
  • ヘルスエンドポイントがHTTP 200を返すことを確認
  • コンテナ起動ログでエラーを確認
  • DockerfileのEXPOSEがingress設定と一致していることを確認

「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
仕様準拠

作れるもの

コンテナアプリのイメージプル失敗をデバッグ

Azure Container Registryからのコンテナイメージプル失敗の原因を診断し、ステップバイステップの修正コマンドを取得

KQLでアプリケーションログを分析

Application Insightsをクエリして、最近のエラー、失敗したリクエスト、パフォーマンスの問題を発見

コールドスタートタイムアウトの問題を修正

レプリカ設定を調整してAzure Container Appsの初回リクエストの遅延問題を特定・解決

これらのプロンプトを試す

基本的な診断リクエスト 
Azure Container Appの起動に失敗しています。azure-diagnosticsスキルを使用して問題を診断するのを手伝ってください。
イメージプル失敗のトラブルシューティング 
Container Appでイメージプルエラーが継続的に発生しています。ACR認証の問題を修正するにはどうすればよいですか？
KQLによるログ分析 
過去1時間のApplication Insightsログでエラーを見つけるためのKQLクエリの作成を手伝ってください。
ヘルスプローブの調査 
ヘルスプローブの失敗によりコンテナが再起動し続けています。何を確認すればよいですか？

ベストプラクティス

  • 詳細なログに入る前にリソースヘルスチェックから始める
  • 体系的な診断フローを使用：症状→ヘルス→ログ→メトリクス→変更
  • 利用可能な場合はAppLens MCPを使用してAI搭載の根本原因分析を行う
  • 将来の参照のために試みたすべての修復手順を文書化

回避

  • コンテナの再起動を調査する際にヘルスチェックをスキップしない
  • HealthResourcesを最初に確認せずにAzureサービスのヘルスを想定しない
  • プロビジョニング状態の失敗を無視しない—これらはデプロイの問題を示している

よくある質問

このスキルは実際に何をするのですか？
このスキルはAzure Container Appsのトラブルシューティングガイド、診断コマンド、KQLクエリを提供します。コマンドは実行しませんが、問題の診断方法を教えます。
このスキルはAzureの問題を修正できますか？
いいえ。このスキルはガイダンスと実行可能なコマンドを提供します。Azure CLIコマンドはAzure認証情報を使用して自分で実行する必要があります。
どのAzureサービスがサポートされていますか？
現在、イメージプル、コールドスタート、ヘルスプローブの問題を含むAzure Container Apps診断を対象としています。より多くのサービスが近日公開予定です。
Azure CLIをインストールする必要がありますか？
はい、表示される診断コマンドを実行するにはAzure CLIがインストールされている必要があります。このスキルはコマンドを提供しますが、az CLIが設定されている必要があります。
AppLensとは何ですか？
AppLensはAI搭載の診断を提供するAzure MCPツールです。問題を自動的に検出し、修復手順を提案できます。
Azure Resource Graphをクエリするにはどうすればよいですか？
intent 'query Azure Resource Graph'を指定してextension_cli_generate MCPツールを使用するか、KQLでaz graph queryコマンドを構築します。

開発者の詳細

作成者

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