5.10. ホストのネットワークトレースの収集

手順

1. 以下のコマンドを実行して、一部のノードでホストネットワークからパケットキャプチャーを実行します。

   $ oc adm must-gather \
       --dest-dir /tmp/captures \
       --source-dir '/tmp/tcpdump/' \
       --image registry.redhat.io/openshift4/network-tools-rhel8:latest \
       --node-selector 'node-role.kubernetes.io/worker' \
       --host-network=true \
       --timeout 30s \
       -- \
       tcpdump -i any \
       -w /tmp/tcpdump/%Y-%m-%dT%H:%M:%S.pcap -W 1 -G 300

   各項目の説明:

   --dest-dir/tmp/captures

   --dest-dir 引数では、oc adm must-gather の実行時に、クライアントマシンの /tmp/captures と相対パスにあるディレクトリーに、キャプチャーしたパケットを保存することを指定します。書き込み可能なディレクトリーを指定できます。

   --source-dir '/tmp/tcpdump/'

   tcpdump が oc adm must-gather の起動先のデバッグ Pod で実行される場合に、--source-dir 引数は、パケットが Pod の /tmp/tcpdump ディレクトリーに一時保存するように指定します。

   -- イメージ registry.redhat.io/openshift4/network-tools-rhel8:latest

   --image 引数は、tcpdump コマンドが含まれるコンテナーイメージを指定します。

   --node-selector 'node-role.kubernetes.io/worker'

   --node-selector 引数および example 値は、ワーカーノードでパケットキャプチャーを実行するように指定します。別の方法としては、代わりに --node-name 引数を指定して、1 つのノードでパケットキャプチャーを実行できます。--node-selector と --node-name 引数の両方を省略すると、パケットキャプチャーはすべてのノードで実行されます。

   --host-network=true

   パケットがノードのネットワークインターフェイスでキャプチャーされるようにするには、--host-network=true 引数が必要です。

   -- タイムアウト 30 秒

   --timeout 引数および値を指定して、デバッグ Pod を 30 秒間実行します。--timeout 引数と期間を指定しない場合、デバッグ Pod は 10 分実行されます。

   -i どれでも

   tcpdump コマンドの -i any 引数は、すべてのネットワークインターフェイスでパケットをキャプチャーするように指定します。また、ネットワークインターフェイス名を指定することもできます。

2. ネットワークトレースがパケットをキャプチャーしている間に、ネットワーク通信の問題を発生させる、Web アプリケーションにアクセスするなど、特定のアクションを実行します。

3. oc adm must-gather で Pod からクライアントマシンに転送したパケットキャプチャーファイルを確認します。

   tmp/captures
   ├── event-filter.html
   ├── ip-10-0-192-217-ec2-internal
   │   └── registry-redhat-io-openshift4-network-tools-rhel8-sha256-bca...
   │       └── 2022-01-13T19:31:31.pcap
   ├── ip-10-0-201-178-ec2-internal
   │   └── registry-redhat-io-openshift4-network-tools-rhel8-sha256-bca...
   │       └── 2022-01-13T19:31:30.pcap
   ├── ip-...
   └── timestamp

   各項目の説明:

   ip-10-0-192-217-ec2-internal、ip-10-0-201-178-ec2-internal

   パケットのキャプチャーは、ホスト名、コンテナー、ファイル名を識別するディレクトリーに保存されます。--node-selector 引数を指定しなかった場合には、ホスト名のディレクトリーレベルは存在しません。