1.15. must-gather コマンドによるトラブルシューティング

Multicluster Global Hub ではさまざまなエラーが発生する可能性があります。Multicluster Global Hub の問題をトラブルシューティングするには、must-gather コマンドを実行できます。

must-gather コマンドを実行して詳細、ログを収集し、問題のデバッグ手順を実行します。このデバッグ情報は、サポートリクエストを開くときにも役立ちます。oc adm must-gather CLI コマンドは、問題のデバッグによく必要となる次のような情報をクラスターから収集します。

must-gather コマンドを実行するには、次の前提条件を満たす必要があります。

must-gather コマンドを使用して情報を収集するには、次の手順を実行します。

OpenShift Container Platform ドキュメントのクラスターに関するデータの収集を読み、must-gather コマンドを学び、必要な前提条件をインストールします。
グローバルハブクラスターにログインします。一般的な使用例では、グローバルハブクラスターにログインしているときに次のコマンドを実行します。
```
oc adm must-gather --image=quay.io/stolostron/must-gather:SNAPSHOTNAME
```
```
oc adm must-gather --image=quay.io/stolostron/must-gather:SNAPSHOTNAME
```
Copy to Clipboard Toggle word wrap
マネージドハブクラスターを確認する場合は、それらのクラスターで must-gather コマンドを実行します。
オプション: 結果を SOMENAME ディレクトリーに保存する場合は、前の手順で 1 つではなく次のコマンドを実行できます。
```
oc adm must-gather --image=quay.io/stolostron/must-gather:SNAPSHOTNAME --dest-dir=<SOMENAME> ; tar -cvzf <SOMENAME>.tgz <SOMENAME>
```
```
oc adm must-gather --image=quay.io/stolostron/must-gather:SNAPSHOTNAME --dest-dir=<SOMENAME> ; tar -cvzf <SOMENAME>.tgz <SOMENAME>
```
Copy to Clipboard Toggle word wrap
ディレクトリーには別の名前を指定できます。
注記: コマンドには、gzipped tarball ファイルを作成するために必要な追加が含まれます。

以下の情報は、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 内のログを確認できます。

トップに戻る