Red Hat Summit9.4. ログとカスタムリソース
トラブルシューティングのためにログおよびカスタムリソース (CR) の情報をダウンロードできます。詳細は、詳細な移行ワークフロー を参照してください。
9.4.1. 収集されるログおよびカスタムリソース情報
Red Hat OpenShift Web コンソールまたはコマンドラインインターフェイス (CLI) を使用すると、以下のターゲットのログとカスタムリソース (CR) yaml ファイルをダウンロードできます。
- 移行計画: Web コンソールまたは CLI。
- 仮想マシン: Web コンソールまたは CLI。
- namespace: CLI のみ。
must-gather ツールは、以下のログおよび CR ファイルをアーカイブファイルで収集します。
CR:
-
DataVolumeCR: 移行された VM にマウントされているディスクを表します。 -
VirtualMachineCR: 移行された VM を表します。 -
PlanCR: VM およびストレージおよびネットワークマッピングを定義します。 -
JobCR: オプション: 移行前のフック、移行後のフック、またはその両方を表します。
-
ログ:
-
ImporterPod: ディスクからデータへのボリューム変換ログ。ImporterPod の命名規則はimporter-<migration_plan>-<vm_id><5_char_id>です。たとえば、importer-mig-plan-ed90dfc6-9a17-4a8btnfhは、ed90dfc6-9a17-4a8が省略された RHV VM ID、btnfhは生成された 5 文字の ID です。 -
conversionPod: VM の変換ログ。conversionPod はvirt-v2vを実行します。これは、VM の PVC にデバイスドライバーをインストールし、設定します。conversionPod の命名規則は<migration_plan>-<vm_id><5_char_id>です。 -
virt-launcherPod: VM ランチャーログ。移行した VM の電源がオンになると、virt-launcherPod は VM ディスクとして割り当てられた PVC でQEMU-KVMを実行します。 -
forklift-controllerPod: ログはmust-gatherコマンドで指定される移行計画、仮想マシン、または namespace に対してフィルター処理されます。 -
forklift-must-gather-apiPod: ログはmust-gatherコマンドで指定される移行計画、仮想マシン、または namespace に対してフィルター処理されます。 hook-jobPod: ログはフックジョブに対してフィルターされます。hook-jobの命名規則は、<migration_plan>-<vm_id><5_char_id> (例:`plan2j-vm-3696-posthook-4mx85またはplan2j-vm-3696-prehook-mwqnl) です。注記空または除外されたログファイルは、
must-gatherアーカイブファイルには含まれません。
-
VMware 移行計画の must-gather アーカイブ構造の例
must-gather
└── namespaces
├── target-vm-ns
│ ├── crs
│ │ ├── datavolume
│ │ │ ├── mig-plan-vm-7595-tkhdz.yaml
│ │ │ ├── mig-plan-vm-7595-5qvqp.yaml
│ │ │ └── mig-plan-vm-8325-xccfw.yaml
│ │ └── virtualmachine
│ │ ├── test-test-rhel8-2disks2nics.yaml
│ │ └── test-x2019.yaml
│ └── logs
│ ├── importer-mig-plan-vm-7595-tkhdz
│ │ └── current.log
│ ├── importer-mig-plan-vm-7595-5qvqp
│ │ └── current.log
│ ├── importer-mig-plan-vm-8325-xccfw
│ │ └── current.log
│ ├── mig-plan-vm-7595-4glzd
│ │ └── current.log
│ └── mig-plan-vm-8325-4zw49
│ └── current.log
└── openshift-mtv
├── crs
│ └── plan
│ └── mig-plan-cold.yaml
└── logs
├── forklift-controller-67656d574-w74md
│ └── current.log
└── forklift-must-gather-api-89fc7f4b6-hlwb6
└── current.log
9.4.2. Web コンソールからのログおよびカスタムリソース情報のダウンロード
Red Hat OpenShift Web コンソールを使用すると、完了、失敗、またはキャンセルされた移行計画、または移行された仮想マシン (VM) のカスタムリソース (CR) に関するログと情報をダウンロードできます。
手順
- Web コンソールで、Migration plans をクリックします。
- 移行計画名の横にある Get logs をクリックします。
Get logs ウィンドウで Get logs をクリックします。
ログが収集されます。
Log collection completeメッセージが表示されます。- Download logs をクリックしてアーカイブファイルをダウンロードします。
- 移行された VM のログをダウンロードするには、移行計画名をクリックして、VM の横にある Get logs をクリックします。
9.4.3. コマンドラインインターフェイスからのログおよびカスタムリソース情報へのアクセス
must-gather ツールを使用して、コマンドラインインターフェイスからカスタムリソース (CR) のログおよび情報にアクセスできます。must-gather データファイルをすべてのカスタマーケースに割り当てる必要があります。
フィルターオプションを使用して、特定の namespace、完了、失敗、またはキャンセルされた移行計画、移行した仮想マシン (VM) のデータを収集できます。
フィルターされた must-gather コマンドで存在しないリソースを指定する場合、アーカイブファイルは作成されません。
前提条件
-
cluster-adminロールを持つユーザーとして OpenShift Virtualization クラスターにログインしている。 -
Red Hat OpenShift CLI (
oc) がインストールされている。
手順
-
must-gatherデータを保存するディレクトリーに移動します。 oc adm must-gatherコマンドを実行します。$ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.4.3
データは
/must-gather/must-gather.tar.gzとして保存されます。このファイルを Red Hat カスタマーポータル で作成したサポートケースにアップロードすることができます。オプション:
oc adm must-gatherコマンドに以下のオプションを指定して実行し、フィルターされたデータを収集します。Namespace:
$ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.4.3 \ -- NS=<namespace> /usr/bin/targeted
移行計画:
$ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.4.3 \ -- PLAN=<migration_plan> /usr/bin/targeted
仮想マシン:
$ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.4.3 \ -- VM=<vm_name> NS=<namespace> /usr/bin/targeted 1- 1
- VM ID ではなく、
PlanCR に表示される VM の名前を指定する必要があります。
