aks-network-capture

AKS ネットワークキャプチャ

クイックリファレンス

用途	必要なもの	安全性
AKS の pcap 証跡	kubectl、Azure の証跡には az	範囲を限定し、固定し、最小権限を適用

このスキルを使用する場面

読み取り専用の確認後に、明示的なパケットキャプチャを行う場合に使用します。一般的な接続障害には使用しません。

MCP ツール

Azure MCP の AKS 領域では、クラスターとノードプールのメタデータを取得できますが、Kubernetes コマンドの実行やパケットキャプチャはできません。

ホスト機能の確認

ワークフローを実行する前に、ホストで必要な Bash または PowerShell の実行、対象のクラスターへの kubectl アクセス、Azure の証跡用の az、同梱スクリプトへのアクセス、および承認済みの成果物の保存先が利用可能であることを確認してください。管理対象の Azure CLI ツールだけでは、シェル、Kubernetes コマンド、または成果物の操作がサポートされているとは判断できません。

必要な機能が利用できない、または禁止されている場合は、このホストではキャプチャを実行できないことを伝えてください。適切に編集された提供済みの証跡を分析するか、対象を限定した収集／キャプチャ計画をオペレーターに提示してください。実行したと主張してはいけません。kubectl を Azure MCP 経由で実行したり、未承認の実行経路を追加したり、ホストのポリシーを回避したりしてはいけません。ホストでのサポートがあっても、以下の変更および機密データに関する承認の代わりにはなりません。

この確認を完了した後に限り、スキルのルートから同梱スクリプトを実行してください。

ワークフロー／手順

0. ホスト機能を確認し、承認と対象の指定を完了します。 キャプチャの意図は変更への同意を意味しません。 デバッグコンテナーへのフォールバックを行う前に、別途承認を得てください。
1. Bash／PowerShellをインストールします。
2. Bash／PowerShellでノードまたはポッドをキャプチャします。
3. 承認を得た場合は、Bash／PowerShellでトラフィックを生成します。
4. Bash／PowerShellで対象の実行分を正確に取得します。
5. Bash／PowerShellで Azure の証跡を収集します。

ConfigMap は、固定された Linux イメージ内で run-capture.sh を実行します。

エラー処理

エラー	対応
入力が無効	再試行する前に修正します。
ConfigMap がない／古い	セットアップを再実行します。
キャプチャ／取得の失敗	Job のログを確認します。証跡が見つからない場合は成功ではありません。