5.2. must-gather 物の量を削減する

oc adm must-gather コマンドは、包括的なクラスター情報を収集します。しかし、完全なデータ収集を行うと、アップロードや分析が困難な大きなファイルが生成され、タイムアウトが発生する可能性がある。

出力サイズを管理し、より効果的なトラブルシューティングのためにデータ収集の対象を絞り込むには、基となる 収集 スクリプトに特定のフラグを渡したり、収集範囲を特定のリソースに限定したりすることができます。

クラスター全体のデータを収集する代わりに、must-gather ツールに特定のリソースを検査するように指示することができます。この方法は、単一のプロジェクト、Operator、またはアプリケーション内の問題を特定するのに非常に効果的です。

must-gather ツールは内部的に oc adm inspect を 使用します。検査対象を指定するには、-- 区切り記号の後に inspect コマンドとその引数を渡します。

手順

my-project などの特定の名前空間のデータを収集するには、次のコマンドを実行します。
```
$ oc adm must-gather --dest-dir=my-project-must-gather -- oc adm inspect ns/my-project
```
このコマンドは、my-project 名前空間内のすべての標準リソース (その名前空間内の Pod からのログを含む) を収集しますが、クラスタースコープのリソースは除外します。
openshift-apiserver などの特定のクラスター Operator に関連するデータを収集するには、次のコマンドを実行します。
```
$ oc adm must-gather --dest-dir=apiserver-must-gather -- oc adm inspect clusteroperator/openshift-apiserver
```
ログを完全に除外して、must-gather アーカイブのサイズを大幅に削減するには、oc adm must-gather コマンドの後に二重ハイフン (--) を追加し、--no-logs 引数を追加します。
```
$ oc adm must-gather -- /usr/bin/gather --no-logs
```