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-launcher Pod 세부 정보를 포함하여 가상 머신 정보를 수집합니다. VirtualMachineVirtualMachineInstance CR 데이터는 모든 네임스페이스에 대해 수집됩니다.
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. 사용법 및 예

환경 변수는 선택 사항입니다. 자체적으로 또는 하나 이상의 호환 환경 변수를 사용하여 스크립트를 실행할 수 있습니다.

표 12.1. 호환 매개변수

스크립트호환 가능한 환경 변수

gather_vms_details

  • 네임스페이스의 경우: NS=<namespace_name>
  • VM의 경우: VM=<vm_name> NS=<namespace_name>
  • PROS=<number_of_processes>

gather

  • PROS=<number_of_processes>

gather_images

  • PROS=<number_of_processes>

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