Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

15.2.3. OpenShift Virtualization の must-gather ツールの使用

OpenShift Virtualization イメージで must-gather コマンドを実行することにより、OpenShift Virtualization リソースに関するデータを収集できます。

デフォルトのデータ収集には、次のリソースに関する情報が含まれています。

  • 子オブジェクトを含む OpenShift Virtualization Operator namespace
  • すべての OpenShift Virtualization カスタムリソース定義
  • 仮想マシンを含むすべての namespace
  • 基本的な仮想マシン定義

オプションの環境詳細とスクリプトを must-gather コマンドに追加して、追加情報を収集できます。これらの環境変数とスクリプトを使用して、特定の仮想マシン、イメージ、またはインスタンスタイプに関するデータを収集します。

前提条件

  • OpenShift CLI (oc) がインストールされている。

手順

  • must-gather コマンドを実行して、OpenShift Virtualization に関するデータを収集します。 

    $ oc adm must-gather \
  --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v4.20.11 \
  -- /usr/bin/gather
    注記

    次のコマンドを実行して、クラスター上のすべての Operator と製品の must-gather ログを収集することもできます。 

    $ oc adm must-gather --all-images

    1. 次のコマンドを実行して、must-gather データの収集時に並行して実行されるプロセスの数を変更します。 

      $ oc adm must-gather \
  --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v4.20.11 \
  -- PROS=<number> /usr/bin/gather

      PROS は、データを収集するために実行される並列プロセスの数を定義します。デフォルトのプロセス数は 5 です。プロセス数を増やすとデータ収集が速くなりますが、使用するリソースも増えます。並列処理の最大数を増やすことは推奨されません。

    2. 次のコマンドを実行して、特定の namespace 内の特定の仮想マシンの詳細情報を収集します。 

      $ oc adm must-gather \
  --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v4.20.11 \
  -- NS=<namespace name> VM=<VM name> /usr/bin/gather --vms_details

      NS は、namespace の環境変数です。VM 環境変数を使用する場合は必須です。

    3. 次のコマンドを実行して、クラスターからイメージ、イメージストリーム、およびイメージストリームタグの情報を収集します。 

      $ oc adm must-gather \
 --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v4.20.11 \
 /usr/bin/gather --images

    4. 次のコマンドを実行して、クラスターからインスタンスタイプに関する情報を収集します。 

      $ oc adm must-gather \
 --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v4.20.11 \
 /usr/bin/gather --instancetypes

15.2.3.1. must-gather ツールオプション
リンクのコピー

複雑な問題のトラブルシューティングや、デフォルトのログ以外の特定のデータを収集するには、クラスターから情報を収集する際に 、must-gather コマンドにオプションのパラメーターを追加します。

次のオプションに対して、スクリプトおよび環境変数の組み合わせを指定できます。

  • namespace から詳細な仮想マシン (VM) 情報の収集する
  • 特定の仮想マシンに関する詳細情報の収集
  • image、image-stream、および image-stream-tags 情報の収集
  • must-gather ツールが使用する並列プロセスの最大数の制限
15.2.3.1.1. 環境変数
リンクのコピー

互換性のあるスクリプトの環境変数を指定できます。

NS=<namespace_name>
指定した namespace から virt-launcher Pod の詳細を含む仮想マシン情報を収集します。VirtualMachine および VirtualMachineInstance CR データはすべての namespace で収集されます。
VM=<vm_name>
特定の仮想マシンに関する詳細を収集します。このオプションを使用するには、NS 環境変数を使用して namespace も指定する必要があります。
PROS=<number_of_processes>

must-gather ツールが使用する並列処理の最大数を変更します。デフォルト値は 5 です。

重要

並列処理が多すぎると、パフォーマンスの問題が発生する可能性があります。並列処理の最大数を増やすことは推奨されません。

15.2.3.1.2. スクリプト
リンクのコピー

各スクリプトは、特定の環境変数の組み合わせとのみ互換性があります。

/usr/bin/gather
デフォルトの must-gather スクリプトを使用します。すべての namespace からクラスターデータが収集され、基本的な仮想マシン情報のみが含まれます。このスクリプトは、PROS 変数とのみ互換性があります。
/usr/bin/gather --vms_details
OpenShift Virtualization リソースに属する VM ログファイル、VM 定義、コントロールプレーンログ、および namespace を収集します。namespace の指定には、その子オブジェクトが含まれます。namespace または仮想マシンを指定せずにこのパラメーターを使用する場合、must-gather ツールはクラスター内のすべての仮想マシンについてこのデータを収集します。このスクリプトはすべての環境変数と互換性がありますが、VM 変数を使用する場合は namespace を指定する必要があります。
/usr/bin/gather --images
image、image-stream、および image-stream-tags カスタムリソース情報を収集します。このスクリプトは、PROS 変数とのみ互換性があります。
/usr/bin/gather --instancetypes
インスタンスタイプの情報を収集します。この情報は現在、デフォルトでは収集されません。ただし、オプションで収集することもできます。
15.2.3.1.3. 使用方法および例
リンクのコピー

スクリプトは、単独で実行することも、1 つ以上の互換性のある環境変数を使用して実行することもできます。

オプションパラメーター付きの must-gather 構文

$ oc adm must-gather \
  --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v4.20.11 \
  -- <environment_variable_1> <environment_variable_2> <script_name>

Expand
表15.2 互換性のあるパラメーター
スクリプト互換性のある環境変数

/usr/bin/gather

* PROS=<number_of_processes>

/usr/bin/gather --vms_details

* namespace の場合: NS=<namespace_name>

* 仮想マシンの場合: VM=<vm_name> NS=<namespace_name>

* PROS=<number_of_processes>

/usr/bin/gather --images

* PROS=<number_of_processes>

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hatトップに戻る