1.3. must-gather コマンドを実行して Multicluster Global Hub の問題をトラブルシューティングする
Multicluster Global Hub の問題をトラブルシューティングするには、must-gather コマンドを実行できます。must-gather コマンドを実行して詳細とログを収集し、問題のデバッグ手順を実行します。このデバッグ情報は、サポートリクエストを開くときにも役立ちます。
oc adm must-gather コマンドは、次の項目の情報を含む、問題のデバッグに必要となることが多いクラスターからの情報を収集します。
- リソース定義
- サービスログ
1.3.1. 前提条件 リンクのコピーリンクがクリップボードにコピーされました!
リンクのコピーリンクがクリップボードにコピーされました!
must-gather コマンドを実行するには、次の前提条件を満たす必要があります。
-
cluster-adminロールを持つユーザーとして、グローバルハブおよびマネージドハブクラスターにアクセスしておく。 - OpenShift Container Platform コマンドラインインターフェイスをローカルマシンにインストールする。詳細は、OpenShift Container Platform ドキュメントの OpenShift CLI スタートガイド を参照してください。
-
OpenShift Container Platform ドキュメントの クラスターに関するデータの収集 を参照し、
must-gatherコマンドを確認して、前提として必要なものをインストールする。
1.3.2. must-gather コマンドの実行 リンクのコピーリンクがクリップボードにコピーされました!
リンクのコピーリンクがクリップボードにコピーされました!
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コマンドを実行します。
以下のリソースの情報が収集されます。
-
2 つのピアレベル:
cluster-scoped-resourcesとnamespacesリソース。 - それぞれに対するサブレベル: クラスタースコープおよび namespace スコープの両方のリソースに対するカスタムリソース定義の API グループ。
-
それぞれに対する次のレベル:
kindでソートされた YAML ファイル -
Multicluster Global Hub クラスターでは、
namespaceリソースでPostgresClusterおよびKafkaを確認できます。 -
グローバルハブクラスターの場合は、Multicluster Global Hub 関連の Pod と、
namespacesリソースのPod内のログを確認できます。 -
マネージドハブクラスターの場合、Multicluster Global Hub エージェント Pod と
namespacesリソースのPod内のログを確認できます。