Antrea コンテナ クラスタのサポート バンドルの収集

詳細なトラブルシューティングと診断の目的で、NSX のサポート バンドル機能を使用して、Antrea コンテナ クラスタ ノードからログ ファイルを収集できます。

NSX では、サポート バンドルの収集要求をトリガした NSX Manager ノードにサポート バンドルをアップロードできます。また、要求で指定したリモート ファイル サーバにサポート バンドルをアップロードすることもできます。NSX Manager ノードにアップロードされているサポート バンドルは、ローカル コンピュータにダウンロードできます。

Antrea コンテナ クラスタのサポート バンドルには、次のコンポーネントのログ ファイルが含まれています。

• Antrea Controller
• Antrea Agent
• 管理プレーン アダプタ
• 中央制御プレーン アダプタ
• Open vSwitch

サポート対象とサポート対象外の機能

• 1 つの NSX Manager ノードから開始できるサポート バンドル収集要求は 1 つだけです。ただし、1 回の収集要求で複数の Antrea コンテナ クラスタのサポート バンドルを収集できます。
• 3 つの管理ノードのある NSX Manager クラスタを使用している場合、各 NSX Manager ノードから 1 つのサポート バンドル収集要求を同時に開始できます。ただし、各収集要求で異なるコンテナ クラスタを選択する必要があります。

  たとえば、NSX Manager ノード A でサポート バンドル収集要求を開始したとします。この収集要求で、コンテナ クラスタ X のコンテナ クラスタ ノード 1 と 2 を選択しています。このとき、コンテナ クラスタ X 内のコンテナ クラスタ ノード 3 と 4 に対する収集要求を NSX Manager ノード B で開始すると、いずれかのサポート バンドル収集要求が失敗します。同じコンテナ クラスタに 2 番目の要求をトリガする場合は、最初の収集要求が完了してから行う必要があります。

• 現在、Antrea コンテナ クラスタでは、NSX Manager Central CLI からのサポート バンドルの収集はサポートされていません。

前提条件

Antrea コンテナ クラスタが NSX に登録されている。

手順

1. ブラウザから、NSX Manager (https://nsx-manager-ip-address) にログインします。
2. [システム] > [サポート バンドル] の順に移動します。
   [バンドルを要求] ページが開きます。

   重要： ブラウザで NSX Manager アプリケーションを起動すると、登録済みの Antrea コンテナ クラスタに関する情報が NSX Manager ユーザー インターフェイスに取得されます。アプリケーションのユーザー インターフェイスがすでに開いている場合、 Antrea コンテナ クラスタの登録情報は自動的に取得されません。この動作は、現在のユーザー インターフェイスのデザインで想定されている動作です。 NSX Manager アプリケーションを開いた後に最初の Antrea コンテナ クラスタを登録した場合は、 [バンドルを要求] ページに移動した後にブラウザを更新してください。手動で更新すると、この操作の次の手順で、ターゲット ノードとして Antrea コンテナ クラスタを選択できるようになります。

   ブラウザの手動更新は 1 回だけ必要になります。新しい Antrea コンテナ クラスタが NSX に登録されるたびに行う必要はありません。

3. サポート バンドル要求に含めるターゲット ノードを選択します。
   使用可能なノードのタイプは次のとおりです。

   • Antrea コンテナ クラスタ
   • NSX Manager ノード
   • Edge
   • ホスト
   • Public Cloud Gateway

   単一のサポート バンドル要求には、NSX 環境内のさまざまなタイプのノードを混在させることができます。たとえば、同じ収集要求で、Antrea コンテナ クラスタのノード、NSX Manager ノード、NSX Edge ノードを選択できます。ただし、この手順では、Antrea コンテナ クラスタに対してのみサポート バンドル収集要求を作成するワークフローについて説明します。

4. [タイプ] ドロップダウン メニューで [Antrea コンテナ クラスタ] を選択します。
5. [コンテナ クラスタ] リストからコンテナ クラスタの名前を選択します。
   複数のコンテナ クラスタがリストに表示されている場合は、コンテナ クラスタ名の最初の数文字を入力します。リストがフィルタリングされ、入力文字と一致するコンテナ クラスタ名のみが表示されます。
   選択したコンテナ クラスタ内のすべてのノードが [使用可能] リストに表示されます。
6. コンテナ クラスタから 1 つ以上のノードを選択し、右矢印をクリックして [選択済み] リストに移動します。
   単一の収集要求で複数の Antrea コンテナ クラスタからノードを選択するには、コンテナ クラスタごとに手順 4 と 5 を繰り返します。
7. （オプション） [ログ収集期間 (日)] テキスト ボックスで、デフォルト値をそのまま使用するか、サポート バンドルに含めるログの日数を指定します。ログの有効期間を日数で指定します。
8. （オプション） サポート バンドルをリモート ファイル サーバにアップロードする場合は、ファイル サーバの設定を指定します。
   1. リモート ファイル サーバの IP アドレスまたはホスト名を入力します。
   2. ファイル転送プロトコルとポート番号を入力します。デフォルトのポート番号は 22 です。
   3. リモート ファイル サーバのユーザー名とパスワードを入力します。
   4. サポート バンドル ファイルをアップロードする宛先フォルダのパスを入力します。
   リモート ファイル サーバの設定が指定されていない場合は、サポート バンドルの収集要求をトリガした NSX Manager ノードにサポート バンドルがアップロードされます。
9. [バンドル収集を開始] をクリックします。
   収集要求のランタイムの詳細が、 [状態] ページに表示されます。収集プロセスには数分かかります。サポート バンドルの作成にかかる時間は、コンテナ クラスタの各ノードから収集するログ ファイルの数によって異なります。
10. 収集プロセスが完了したら、[ダウンロード] をクリックします。
    サポート バンドル ファイルがローカル コンピュータに保存されます。リモート ファイル サーバの設定を指定した場合、ユーザー インターフェイスに [ダウンロード] ボタンは表示されません。

結果

サポート バンドル収集要求により、nsx_support_archive_datestamp_timestamp.tar という形式の名前で単一のテープ アーカイブ (TAR) ファイルが生成されます。

次の状況では、サポート バンドル収集要求が失敗する可能性があります。

• サポート バンドル要求の処理中にコンテナ クラスタの Antrea NSX Adapter が失敗すると、そのコンテナ クラスタのログの収集に失敗します。
• サポート バンドル要求の処理中に NSX Manager アプライアンスに障害が発生するか、到達不能になると、ログの収集に失敗します。NSX Manager との接続の問題が解決されるまでは、Antrea (antctl) のネイティブ コマンドライン ツールを使用して、Antrea コンテナ クラスタからログ ファイルを収集できます。

部分的成功のシナリオ

サポート バンドルの収集用として、単一の Antrea コンテナ クラスタから 10 個のノードを選択したとします。収集プロセスで、コンテナ クラスタ内の 5 個のノードからログ ファイルが正常に収集されましたが、残りの 5 個では収集されませんでした。つまり、収集要求は部分的に成功しました。この状況では、収集要求の状態は Successful になり、成功した 5 つのノードのログがサポート バンドル ファイル (TAR) に含まれます。

次のタスク

1. TAR ファイルを抽出します。次のファイルが表示されます。

   ファイル名	説明
   manifest.json	このファイルには、収集要求の結果のサマリと収集要求のプロパティが含まれます。 たとえば、次の情報が含まれます。 収集に成功したノード。 収集に失敗したノード。 収集要求で使用されたクラスタ ID とノード ID。
   nsx_antrea_cluster-id.tgz	サポート バンドル内の各 Antrea コンテナ クラスタに 1 つの .tgz アーカイブ ファイルが作成されます。

2. nsx_antrea_cluster-id.tgz ファイルを展開します。次のファイルが表示されます。

   ファイル名	説明
   adapters.tar.gz	このアーカイブ ファイルには、管理プレーン アダプタ と 中央制御プレーン アダプタ のログ ファイルが含まれます。
   agent_node_name.tar.gz	このアーカイブ ファイルには、Antrea Agent と Open vSwitch のログ ファイルが含まれます。収集要求により、コンテナ クラスタ ノードごとに 1 つのアーカイブ ファイルが生成されます。 このアーカイブ ファイルを抽出すると、次のファイルが生成されます。 agentinfo ファイル エージェント ログ (/logs/agent) Open vSwitch ログ (/logs/ovs) OpenFlow ダンプ IPtables ルート ダンプ
   clusterinfo	このファイルは、サポート バンドル要求の各コンテナ クラスタに対して生成されます。ファイルには、ポッド、ノード、デプロイ、ReplicaSet、DaemonSet など、Kubernetes API サーバから収集されるさまざまな Kubernetes リソースの情報が含まれています。
   controller.tar.gz	このアーカイブ ファイルには、Antrea Controller のログ ファイルが含まれます。 このアーカイブ ファイルを抽出すると、次のファイルが生成されます。 controllerinfo ファイル コントローラのログ (/logs/controller)