4.4.8. must-gather ツールの使用

手順

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

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

   • Prometheus メトリックを含む、完全な must-gather データ収集:

     $ oc adm must-gather --image=registry.redhat.io/oadp/oadp-mustgather-rhel8:v1.0

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

   • Prometheus メトリックを使用しない、特定の期間の必須の must-gather データ収集:

     $ oc adm must-gather --image=registry.redhat.io/oadp/oadp-mustgather-rhel8:v1.0 \
       -- /usr/bin/gather_<time>_essential 1

     1

     期間を時間単位で指定します。許可される値は、1h、6h、24h、72h、または all です。たとえば、gather_1h_essential または gather_all_essential です。

   • タイムアウト付きの must-gather データ収集:

     $ oc adm must-gather --image=registry.redhat.io/oadp/oadp-mustgather-rhel8:v1.0 \
       -- /usr/bin/gather_with_timeout <timeout> 1

     1

     タイムアウト値を秒単位で指定します。

   • Prometheus メトリクスデータダンプ:

     $ oc adm must-gather --image=registry.redhat.io/oadp/oadp-mustgather-rhel8:v1.0 \
       -- /usr/bin/gather_metrics_dump

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

手順

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

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

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

   $ make prometheus-run

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

   出力

   Started Prometheus on http://localhost:9090

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

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

   $ make prometheus-cleanup