12.8.3. OpenShift Virtualization에 must-gather 툴 사용
OpenShift Virtualization 이미지로 must-gather 명령을 실행하여 OpenShift Virtualization 리소스에 대한 데이터를 수집할 수 있습니다.
기본 데이터 컬렉션에는 다음 리소스에 대한 정보가 포함됩니다.
- 하위 오브젝트를 포함한 OpenShift Virtualization Operator 네임스페이스
- OpenShift Virtualization 사용자 정의 리소스 정의
- 가상 머신이 포함된 네임스페이스
- 기본 가상 머신 정의
절차
다음 명령을 실행하여 OpenShift Virtualization에 대한 데이터를 수집합니다.
$ oc adm must-gather --image-stream=openshift/must-gather \ --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel8:v{HCOVersion}
12.8.3.1. must-gather 툴 옵션
다음 옵션에 대한 스크립트 및 환경 변수 조합을 지정할 수 있습니다.
- 네임스페이스에서 자세한 VM(가상 머신) 정보 수집
- 지정된 VM에 대한 세부 정보 수집
- 이미지 및 이미지 스트림 정보 수집
-
must-gather툴에서 사용하는 최대 병렬 프로세스 수 제한
12.8.3.1.1. 매개 변수
환경 변수
호환되는 스크립트의 환경 변수를 지정할 수 있습니다.
NS=<namespace_name>-
지정하는 네임스페이스에서
virt-launcherPod 세부 정보를 포함하여 가상 머신 정보를 수집합니다.VirtualMachine및VirtualMachineInstanceCR 데이터는 모든 네임스페이스에 대해 수집됩니다. VM=<vm_name>-
특정 가상 머신에 대한 세부 정보를 수집합니다. 이 옵션을 사용하려면
NS환경 변수를 사용하여 네임스페이스도 지정해야 합니다. PROS=<number_of_processes>must-gather툴이 사용하는 최대 병렬 프로세스 수를 수정합니다. 기본값은5입니다.중요너무 많은 병렬 프로세스를 사용하면 성능 문제가 발생할 수 있습니다. 최대 병렬 프로세스 수를 늘리는 것은 권장되지 않습니다.
scripts
각 스크립트는 특정 환경 변수 조합과만 호환됩니다.
gather_vms_details-
OpenShift Virtualization 리소스에 속하는 VM 로그 파일, VM 정의 및 네임스페이스(및 해당 하위 오브젝트)를 수집합니다. 네임스페이스 또는 VM을 지정하지 않고 이 매개변수를 사용하는 경우
must-gather툴은 클러스터의 모든 VM에 대해 이 데이터를 수집합니다. 이 스크립트는 모든 환경 변수와 호환되지만VM변수를 사용하는 경우 네임스페이스를 지정해야 합니다. gather-
모든 네임스페이스에서 클러스터 데이터를 수집하고 기본 VM 정보만 포함하는 기본
must-gather스크립트를 사용합니다. 이 스크립트는PROS변수와만 호환됩니다. gather_images-
이미지 및 이미지 스트림 사용자 정의 리소스 정보를 수집합니다. 이 스크립트는
PROS변수와만 호환됩니다.
12.8.3.1.2. 사용법 및 예
환경 변수는 선택 사항입니다. 자체적으로 또는 하나 이상의 호환 환경 변수를 사용하여 스크립트를 실행할 수 있습니다.
| 스크립트 | 호환 가능한 환경 변수 |
|---|---|
|
|
|
|
|
|
|
|
|
must-gather 가 수집하는 데이터를 사용자 정의하려면 명령에 이중 대시 (--)를 추가한 다음 공백 및 하나 이상의 호환 가능한 매개변수를 추가합니다.
구문
$ oc adm must-gather \ --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel8:v2.5.8 \ -- <environment_variable_1> <environment_variable_2> <script_name>
VM 세부 정보
다음 명령은 mynamespace 네임스페이스에서 my-vm VM에 대한 자세한 VM 정보를 수집합니다.
$ oc adm must-gather \
--image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel8:v2.5.8 \
-- NS=mynamespace VM=my-vm gather_vms_details 1- 1
VM환경 변수를 사용하는 경우NS환경 변수는 필수입니다.
세 개의 병렬 프로세스로 제한되는 기본 데이터 수집
다음 명령은 최대 세 개의 병렬 프로세스를 사용하여 기본 must-gather 정보를 수집합니다.
$ oc adm must-gather \ --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel8:v2.5.8 \ -- PROS=3 gather
이미지 및 이미지 스트림 정보
다음 명령은 클러스터에서 이미지 및 이미지 스트림 정보를 수집합니다.
$ oc adm must-gather \ --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel8:v2.5.8 \ -- gather_images
