10.3. ログおよびデバッグツール

手順

1. MTC Web コンソールで、Migration plans をクリックします。
2. 移行計画の横にある Migrations 番号をクリックし、Migrations ページを表示します。
3. 移行をクリックして、移行の詳細を表示します。

4. Migration resources を展開して、移行リソースおよびそれらのステータスをツリービューで表示します。

   注記

   移行の失敗をトラブルシューティングするには、失敗した高レベルのリソースで開始し、リソースツリーでより低い位置にあるリソースまで堀り下げます。

5. リソースの横にある Options メニュー をクリックし、以下のオプションのいずれかを選択します。

   • copy oc describe コマンド は、コマンドをクリップボードにコピーします。

     • 関連するクラスターにログインしてから、コマンドを実行します。

       リソースの条件およびイベントは YAML 形式で表示されます。

   • Copy oc logs コマンド は、コマンドをクリップボードにコピーします。

     • 関連するクラスターにログインしてから、コマンドを実行します。

       リソースがログフィルターに対応していると、フィルターされたログが表示されます。

   • JSON ビューは、Web ブラウザーで JSON 形式でリソースデータを表示します。

     データは oc get <resource> コマンドの出力と同じです。

手順

1. MTC Web コンソールで、Migration plans をクリックします。
2. 移行計画の横にある Migrations 番号をクリックします。
3. View logs をクリックします。
4. コピーアイコンをクリックして、oc logs コマンドをクリップボードにコピーします。

5. 関連するクラスターにログインし、CLI でコマンドを実行します。

   移行契約の集約ログが表示されます。

手順

1. mig-log-reader Pod を取得します。

   $ oc -n openshift-migration get pods | grep log

   Copy to Clipboard Toggle word wrap

2. 以下のコマンドを実行して、単一の移行ログを表示します。

   $ oc -n openshift-migration logs -f <mig-log-reader-pod> -c color 

   1

   Copy to Clipboard Toggle word wrap

   1

   -c plain オプションは、色なしでログを表示します。

手順

1. OpenShift Container Platform Web コンソールで、Observe Metrics をクリックします。

2. PromQL クエリーを入力し、表示する期間を選択し、Run Queries をクリックします。

   Web ブラウザーにすべての結果が表示されない場合は、Prometheus コンソールを使用します。

手順

1. must-gather データを保存するディレクトリーに移動します。

2. 次のデータ収集オプションのいずれかに対して、oc adm must-gather コマンドを実行します。

   • 過去 1 時間のデータを収集するには、以下を実行します。

     $ oc adm must-gather --image=registry.redhat.io/rhmtc/openshift-migration-must-gather-rhel8:v1.7

     Copy to Clipboard Toggle word wrap

     データは must-gather/must-gather.tar.gz として保存されます。このファイルを Red Hat カスタマーポータル で作成したサポートケースにアップロードすることができます。

   • 過去 24 時間のデータを収集するには、以下を実行します。

     $ oc adm must-gather --image=registry.redhat.io/rhmtc/openshift-migration-must-gather-rhel8:v1.7 \
       -- /usr/bin/gather_metrics_dump

     Copy to Clipboard Toggle word wrap

     この操作には長時間かかる場合があります。データは must-gather/metrics/prom_data.tar.gz として保存されます。

手順

1. prom_data.tar.gz ファイルを解凍します。

   $ tar -xvzf must-gather/metrics/prom_data.tar.gz

   Copy to Clipboard Toggle word wrap

2. ローカルの Prometheus インスタンスを作成します。

   $ make prometheus-run

   Copy to Clipboard Toggle word wrap

   このコマンドでは、Prometheus URL が出力されます。

   出力

   Started Prometheus on http://localhost:9090

   Copy to Clipboard Toggle word wrap

3. Web ブラウザーを起動して URL に移動し、Prometheus Web コンソールを使用してデータを表示します。

4. データを確認した後に、Prometheus インスタンスおよびデータを削除します。

   $ make prometheus-cleanup

   Copy to Clipboard Toggle word wrap

手順

1. MigMigration CR のステータスを確認します。

   $ oc get migmigration <migmigration> -o yaml

   Copy to Clipboard Toggle word wrap

   出力例

   status:
     conditions:
     - category: Warn
       durable: true
       lastTransitionTime: "2021-01-26T20:48:40Z"
       message: 'Final Restore openshift-migration/ccc7c2d0-6017-11eb-afab-85d0007f5a19-x4lbf: partially failed on destination cluster'
       status: "True"
       type: VeleroFinalRestorePartiallyFailed
     - category: Advisory
       durable: true
       lastTransitionTime: "2021-01-26T20:48:42Z"
       message: The migration has completed with warnings, please look at `Warn` conditions.
       reason: Completed
       status: "True"
       type: SucceededWithWarnings

   Copy to Clipboard Toggle word wrap

2. Velero describe コマンドを使用して Restore CR のステータスを確認します。

   $ oc -n {namespace} exec deployment/velero -c velero -- ./velero \
     restore describe <restore>

   Copy to Clipboard Toggle word wrap

   出力例

   Phase:  PartiallyFailed (run 'velero restore logs ccc7c2d0-6017-11eb-afab-85d0007f5a19-x4lbf' for more information)
   
   Errors:
     Velero:     <none>
     Cluster:    <none>
     Namespaces:
       migration-example:  error restoring example.com/migration-example/migration-example: the server could not find the requested resource

   Copy to Clipboard Toggle word wrap

3. Velero logs コマンドを使用して Restore CR ログを確認します。

   $ oc -n {namespace} exec deployment/velero -c velero -- ./velero \
     restore logs <restore>

   Copy to Clipboard Toggle word wrap

   出力例

   time="2021-01-26T20:48:37Z" level=info msg="Attempting to restore migration-example: migration-example" logSource="pkg/restore/restore.go:1107" restore=openshift-migration/ccc7c2d0-6017-11eb-afab-85d0007f5a19-x4lbf
   time="2021-01-26T20:48:37Z" level=info msg="error restoring migration-example: the server could not find the requested resource" logSource="pkg/restore/restore.go:1170" restore=openshift-migration/ccc7c2d0-6017-11eb-afab-85d0007f5a19-x4lbf

   Copy to Clipboard Toggle word wrap

   Restore CR のログエラーメッセージの the server could not find the requested resource は、部分的に失敗した移行の原因を示します。

手順

1. openshift-migration namespace の MigMigration CR を一覧表示します。

   $ oc get migmigration -n openshift-migration

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                                   AGE
   88435fe0-c9f8-11e9-85e6-5d593ce65e10   6m42s

   Copy to Clipboard Toggle word wrap

2. MigMigration CR を検査します。

   $ oc describe migmigration 88435fe0-c9f8-11e9-85e6-5d593ce65e10 -n openshift-migration

   Copy to Clipboard Toggle word wrap

   出力は以下の例のようになります。