1.15. must-gather コマンドによるトラブルシューティング
1.15.1. 症状: Multicluster Global Hub のエラー リンクのコピーリンクがクリップボードにコピーされました!
Multicluster Global Hub ではさまざまなエラーが発生する可能性があります。Multicluster Global Hub の問題をトラブルシューティングするには、must-gather コマンドを実行できます。
1.15.2. 問題の解決: デバッグのために must-gather コマンドを実行する リンクのコピーリンクがクリップボードにコピーされました!
must-gather コマンドを実行して詳細、ログを収集し、問題のデバッグ手順を実行します。このデバッグ情報は、サポートリクエストを開くときにも役立ちます。oc adm must-gather CLI コマンドは、問題のデバッグによく必要となる次のような情報をクラスターから収集します。
- リソース定義
- サービスログ
1.15.2.1. 前提条件 リンクのコピーリンクがクリップボードにコピーされました!
must-gather コマンドを実行するには、次の前提条件を満たす必要があります。
-
cluster-adminロールを持つユーザーとして、グローバルハブおよびマネージドハブクラスターにアクセスします。 - OpenShift Container Platform CLI (oc) がインストールされている。
1.15.2.2. must-gather コマンドの実行 リンクのコピーリンクがクリップボードにコピーされました!
must-gather コマンドを使用して情報を収集するには、次の手順を実行します。
-
OpenShift Container Platform ドキュメントの クラスターに関するデータの収集 を参照し、
must-gatherコマンドを確認して、前提として必要なものをインストールします。 グローバルハブクラスターにログインし、次のコマンドを実行します。
oc adm must-gather --image=registry.redhat.io/rhacm2/acm-must-gather-rhel9:v2.13 --dest-dir=<directory>
oc adm must-gather --image=registry.redhat.io/rhacm2/acm-must-gather-rhel9:v2.13 --dest-dir=<directory>Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
マネージドハブクラスターを確認する場合は、それらのクラスターで
must-gatherコマンドを実行します。
以下の情報は、must-gather コマンドから収集されます。
-
2 つのピアレベル:
cluster-scoped-resourcesとnamespacesリソース。 - それぞれに対するサブレベル: クラスタースコープおよび namespace スコープの両方のリソースに対するカスタムリソース定義の API グループ。
- それぞれの次のレベル: 種類別にソートされた YAML ファイル。
-
グローバルハブクラスターの場合は、
namespacesリソースのPostgresClusterとKafkaを確認できます。 -
グローバルハブクラスターの場合は、Multicluster Global Hub 関連の Pod と、
namespacesリソースのPod内のログを確認できます。 -
マネージドハブクラスターの場合、Multicluster Global Hub エージェント Pod と
namespacesリソースのPod内のログを確認できます。