1.3. must-gather コマンドを実行して Multicluster Global Hub の問題をトラブルシューティングする
Multicluster Global Hub の問題をトラブルシューティングするには、must-gather コマンドを実行できます。must-gather コマンドを実行して詳細とログを収集し、問題のデバッグ手順を実行します。このデバッグ情報は、サポートリクエストを開くときにも役立ちます。
oc adm must-gather コマンドは、次の項目の情報を含む、問題のデバッグに必要となることが多いクラスターからの情報を収集します。
- リソース定義
- サービスログ
前提条件
must-gather コマンドを実行するには、次の前提条件を満たす必要があります。
-
cluster-adminロールを持つユーザーとして、グローバルハブおよびマネージドハブクラスターにアクセスしておく。 - OpenShift Container Platform コマンドラインインターフェイスをローカルマシンにインストールする。詳細は、OpenShift Container Platform ドキュメントの OpenShift CLI スタートガイド を参照してください。
-
OpenShift Container Platform ドキュメントの クラスターに関するデータの収集 を参照し、
must-gatherコマンドを確認して、前提として必要なものをインストールする。
1.3.1. must-gather コマンドの実行 リンクのコピーリンクがクリップボードにコピーされました!
must-gather コマンドを使用して情報を収集するには、次の手順を実行します。
- グローバルハブクラスターにログインします。
以下のコマンドを実行します。
oc adm must-gather --image=registry.redhat.io/rhacm2/acm-must-gather-rhel9:v2.16 --dest-dir=<directory>マネージドハブクラスターを確認する場合は、それらのクラスターで
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内のログを確認できます。
-
2 つのピアレベル:
問題をデバッグするために、Multicluster Global Hub データベースをダンプします。PostgreSQL データベースには、データベースの内容をダンプするための
pg_dumpコマンドラインツールが用意されています。localhostデータベースサーバーからデータをダンプするには、次のコマンドを実行します。pg_dump hoh > hoh.sqlリモートサーバー上にある Multicluster Global Hub データベースを圧縮形式でダンプするには、コマンドラインオプションを使用して接続の詳細を制御します。
hoh.sqlまたはhoh-$(date +%d-%m-%y_%H-%M).tarを置き換えます。以下のコマンドを実行します。pg_dump -h my.host.com -p 5432 -U postgres -F t hoh -f hoh-$(date +%d-%m-%y_%H-%M).tar