第2章 must-gather を使用したログファイルおよび診断情報のダウンロード

前提条件

• オプション: OpenShift Data Foundation が非接続環境にデプロイされている場合、個別の must-gather イメージを非接続環境で利用できるミラーレジストリーにミラーリングするようにしてください。

  $ oc image mirror registry.redhat.io/odf4/ocs-must-gather-rhel8:v4.9 <local-registry>/odf4/ocs-must-gather-rhel8:v4.9 [--registry-config=<path-to-the-registry-config>] [--insecure=true]

  <local-registry>

  非接続の OpenShift Container Platform クラスターで利用可能なローカルイメージのミラーレジストリーです。

  <path-to-the-registry-config>

  レジストリー認証情報へのパスで、デフォルトは ~/.docker/config.json です。

  --insecure

  ミラーレジストリーがセキュアでない場合にのみこのフラグを追加します。

  詳細は、Red Hat ナレッジベースソリューションを参照してください。

  • Redhat Openshift レジストリー間でイメージをミラーリングする方法
  • プライベートレジストリーが安全でない場合の OpenShift イメージリポジトリーのミラーリングに失敗しました。

手順

• Red Hat OpenShift Data Foundation クラスターに接続されているクライアントから must-gather コマンドを実行します。

  $ oc adm must-gather --image=registry.redhat.io/odf4/ocs-must-gather-rhel8:v4.9 --dest-dir=<directory-name>

  <directory-name>

  データを書き込むディレクトリーの名前です。

  重要

  非接続環境のデプロイメントの場合は、--image パラメーターのイメージをミラーリングされた must-gather イメージに置き換えます。

  $ oc adm must-gather --image=<local-registry>/odf4/ocs-must-gather-rhel8:v4.9 --dest-dir=<directory-name>

  <local-registry>

  非接続の OpenShift Container Platform クラスターで利用可能なローカルイメージのミラーレジストリーです。

  これにより、指定されたディレクトリーに以下の情報が収集されます。

  • すべての Red Hat OpenShift Data Foundation クラスター関連のカスタムリソース (CR) とそれらの namespace。
  • すべての Red Hat OpenShift Data Foundation 関連の Pod の Pod ログ。
  • ステータス、クラスターの正常性などの一部の標準的な Ceph コマンドの出力。

コマンドの差異

• 状態が Ready ではないマスターノードが 1 つ以上ある場合には、must-gather Pod を安全にスケジュールできるように --node-name を使用して Ready のマスターノードを指定します。

  $ oc adm must-gather --image=registry.redhat.io/odf4/ocs-must-gather-rhel8:v4.9 --dest-dir=<directory-name> --node-name=<node-name>

• 特定の時点から情報を収集する場合は、以下を行います。

  • たとえば 5 秒以内または 2 日以内に収集されたログの相対的な期間を指定するには、/usr/bin/gather since=<duration> を追加します。

    $ oc adm must-gather --image=registry.redhat.io/odf4/ocs-must-gather-rhel8:v4.9 --dest-dir=<directory-name> /usr/bin/gather since=<duration>

  • その後にログを収集する特定の時間を指定するには、/usr/bin/gather since-time=<rfc3339-timestamp> を追加します。

    $ oc adm must-gather --image=registry.redhat.io/odf4/ocs-must-gather-rhel8:v4.9 --dest-dir=<directory-name> /usr/bin/gather since-time=<rfc3339-timestamp>

  以下のように、これらのコマンドのサンプルの値を置き換えます。

  <node-name>

  状態が Ready ではないマスターノードが 1 つ以上ある場合には、このパラメーターを使用して、状態がまだ Ready のマスターノード名を指定します。これにより、must-gather Pod が準備状態にないマスターノードにスケジュールされないようにすることで、スケジューリングエラーを回避します。

  <directory-name>

  must-gather によって収集される情報を保存するディレクトリー。

  <duration>

  5h (5 時間前から開始する) など、相対的な期間として情報を収集する期間 (の開始点) を指定します。

  <rfc3339-timestamp>

  2020-11-10T04:00:00+00:00 (2020 年 11 月 11 日の 4am UTC から開始する) など、RFC 3339 タイムスタンプとして情報を収集する期間 (の開始点) を指定します。