Azure Diagnostics

権限のあるガイダンス — 必須遵守

このドキュメントは、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 Messaging SDK の問題をトラブルシューティングする (Event Hubs、Service Bus 接続失敗、AMQP エラー、メッセージロック問題)

ルール

1. 体系的な診断フローで開始する
2. 利用可能な場合は AppLens (MCP) を AI 駆動の診断に使用する
3. ログを深掘りする前にリソースヘルスを確認する
4. サービスタイプに基づいて適切なトラブルシューティングガイドを選択する
5. 調査結果と試みた修復ステップを記録する
6. AKS インシデントを専用の 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 Troubleshooting
Messaging	Event Hubs & Service Bus SDK エラー、AMQP 失敗、メッセージロック、接続性	Messaging Troubleshooting

---

ルーティング

• Container Apps および Function Apps の診断はこの親スキルに保つ。
• アクティブな AKS インシデント、AKS 固有のインテーク、エビデンス収集、および修復ガイダンスを AKS Troubleshooting にルーティングする。
• Azure Messaging SDK トラブルシューティング (Event Hubs、Service Bus) を Messaging Troubleshooting にルーティングする。

---

クイックリファレンス

一般的な診断コマンド

# 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 Query Library
• Azure Resource Graph Queries
• App Service Troubleshooting
• Function Apps Troubleshooting
• Messaging Troubleshooting