azure-diagnostics

Azure 診断

権威あるガイダンス — 必ず遵守してください

このドキュメントは、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 クラスター、ノード、ポッド、イングレス、または Kubernetes ネットワークの問題をトラブルシューティングする
• Azure VM の接続問題（RDP／SSH の失敗、ポート 3389／22 のタイムアウト、NSG またはファイアウォールによるブロック、資格情報のリセット）をトラブルシューティングする
• Azure Messaging SDK の問題（Event Hubs、Service Bus の接続失敗、AMQP エラー、メッセージロックの問題）をトラブルシューティングする
• 正常に稼働しているのに宛先が誤っているように見える症状の根本原因を特定する（例：構成変更後、テレメトリ／メッセージが想定されるリソースに送信されなくなる）。MCP ツールだけで表面的な問題に回答できる場合でも、このスキルを呼び出してマトリックスを確認してください

ルール

1. 体系的な診断フローから始めてください
2. 提供された証拠を最初に使用してください。ユーザーが証拠のみでの分析を求めている場合、または Azure へのライブアクセスを禁止している場合は、Azure のクエリや変更を行わないでください。提供されたログ、メトリック、タイムラインから診断し、前提を明示して、任意の検証手順を提示してください。
3. 利用可能な場合は、AI を活用した診断に AppLens（MCP）を使用してください
4. ログを詳しく調べる前に、リソースの正常性を確認してください
5. サービスの種類に応じて、適切なトラブルシューティングガイドを選択してください
6. 調査結果と試行した修復手順を記録してください
7. 識別子がわかっている場合、許可されたライブデータ収集には、場当たり的な呼び出しよりも同梱の診断スクリプトを優先してください。提供された証拠で十分な場合、またはライブアクセスが禁止されている場合は実行せず、それ以外の場合は該当するスクリプトを最初に実行してください。
8. AKS のインシデントは、専用の AKS トラブルシューティングドキュメントに振り分けてください
9. オプションの aks-skills アドオンがない場合、ユーザーが利用を拒否した場合、またはホストでサポートされていない場合でも、AKS の基本的な診断を利用できる状態にしておいてください

---

迅速な診断フロー

1. 症状を特定する - 何が失敗していますか？
2. リソースの正常性を確認する - Azure は正常ですか？
3. ログを確認する - ログには何が示されていますか？
4. メトリックを分析する - パフォーマンスのパターンはありますか？
5. 最近の変更を調査する - 何が変更されましたか？

---

サービス別のトラブルシューティングガイド

サービス	よくある問題	参照先
Container Apps	イメージのプル失敗、コールドスタート、ヘルスプローブ、ポートの不一致	container-apps/
App Service	高 CPU 使用率、デプロイの失敗、クラッシュ、応答の遅延、TLS／カスタムドメイン	app-service/
Function Apps	アプリの詳細、呼び出しの失敗、タイムアウト、バインディングエラー、コールドスタート、アプリ設定の欠落	functions/
AKS	クラスターへのアクセス、ノード、kube-system、スケジューリング、クラッシュループ、イングレス、DNS、アップグレード	AKS のトラブルシューティング
Compute	VM の RDP／SSH 接続、NSG／ファイアウォールによるブロック、資格情報のリセット、VM エージェント／ツールの問題	VM 接続のトラブルシューティング
Messaging	Event Hubs と Service Bus の SDK エラー、AMQP の失敗、メッセージロック、接続性	Messaging のトラブルシューティング

---

ルーティング

• Container Apps と Function Apps の診断は、この親スキルに含めます。
• AKS の進行中のインシデント、AKS 固有の受付、証拠の収集、修復に関するガイダンスは、AKS のトラブルシューティングにルーティングします。
• Azure VM の RDP／SSH 接続、NSG／ファイアウォール、資格情報のリセット、VM エージェントのトラブルシューティングは、VM 接続のトラブルシューティングにルーティングします。
• Azure Messaging SDK のトラブルシューティング（Event Hubs、Service Bus）は、Messaging のトラブルシューティングにルーティングします。

---

クイックリファレンス

一般的な診断コマンド

# Check resource health
az resource show --ids RESOURCE_ID
# View activity log
az monitor activity-log list -g RG --max-events 20
# Container Apps logs
az containerapp logs show --name APP -g RG --follow
# Function App logs (query App Insights traces)
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>"

Provides:
- Automated issue detection
- Root cause analysis
- Remediation recommendations

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 を使用する

# Check specific resource health
az resource show --ids RESOURCE_ID

# Check recent activity
az monitor activity-log list -g RG --max-events 20

---

参考資料

• KQL クエリライブラリ
• Azure Resource Graph クエリ
• App Service のトラブルシューティング
• Function Apps のトラブルシューティング
• VM 接続のトラブルシューティング
• Messaging のトラブルシューティング