Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

14.2.3. OpenShift Virtualization에 must-gather 툴 사용

OpenShift Virtualization 이미지로 must-gather 명령을 실행하여 OpenShift Virtualization 리소스에 대한 데이터를 수집할 수 있습니다.

기본 데이터 컬렉션에는 다음 리소스에 대한 정보가 포함됩니다.

  • 하위 오브젝트를 포함한 OpenShift Virtualization Operator 네임스페이스
  • OpenShift Virtualization 사용자 정의 리소스 정의
  • 가상 머신이 포함된 네임스페이스
  • 기본 가상 머신 정의

절차

  • 다음 명령을 실행하여 OpenShift Virtualization에 대한 데이터를 수집합니다. 

    $ oc adm must-gather \
  --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v4.13.11 \
  -- /usr/bin/gather

14.2.3.1. must-gather 툴 옵션
링크 복사

다음 옵션에 스크립트 및 환경 변수 조합을 지정할 수 있습니다.

  • 네임스페이스에서 자세한 VM(가상 머신) 정보 수집
  • 지정된 VM에 대한 자세한 정보 수집
  • 이미지, 이미지 스트림 및 image-stream-tags 정보 수집
  • must-gather 툴에서 사용하는 최대 병렬 프로세스 수 제한
14.2.3.1.1. 매개 변수
링크 복사

환경 변수

호환되는 스크립트의 환경 변수를 지정할 수 있습니다.

NS=<namespace_name>
지정한 네임스페이스에서 virt-launcher Pod 세부 정보를 포함한 가상 머신 정보를 수집합니다. VirtualMachine 및 VirtualMachineInstance CR 데이터는 모든 네임스페이스에 대해 수집됩니다.
VM=<vm_name>
특정 가상 머신에 대한 세부 정보를 수집합니다. 이 옵션을 사용하려면 NS 환경 변수를 사용하여 네임스페이스도 지정해야 합니다.
PROS=<number_of_processes>

must-gather 툴에서 사용하는 최대 병렬 프로세스 수를 수정합니다. 기본값은 5 입니다.

중요

병렬 프로세스를 너무 많이 사용하면 성능 문제가 발생할 수 있습니다. 최대 병렬 프로세스 수를 늘리는 것은 권장되지 않습니다.

스크립트

각 스크립트는 특정 환경 변수 조합과만 호환됩니다.

/usr/bin/gather
모든 네임스페이스에서 클러스터 데이터를 수집하고 기본 VM 정보만 포함하는 기본 must-gather 스크립트를 사용합니다. 이 스크립트는 PROS 변수와만 호환됩니다.
/usr/bin/gather --vms_details
VM 로그 파일, VM 정의, 컨트롤 플레인 로그 및 OpenShift Virtualization 리소스에 속하는 네임스페이스를 수집합니다. 네임스페이스를 지정하면 해당 하위 오브젝트가 포함됩니다. 네임스페이스 또는 VM을 지정하지 않고 이 매개변수를 사용하는 경우 must-gather 툴에서 클러스터의 모든 VM에 대해 이 데이터를 수집합니다. 이 스크립트는 모든 환경 변수와 호환되지만 VM 변수를 사용하는 경우 네임스페이스를 지정해야 합니다.
/usr/bin/gather --images
이미지, 이미지 스트림 및 image-stream-tags 사용자 정의 리소스 정보를 수집합니다. 이 스크립트는 PROS 변수와만 호환됩니다.
14.2.3.1.2. 사용 및 예
링크 복사

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

Expand
표 14.2. 호환되는 매개변수
스크립트호환 가능한 환경 변수

/usr/bin/gather

  • PROS=<number_of_processes>

/usr/bin/gather --vms_details

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

/usr/bin/gather --images

  • PROS=<number_of_processes>

구문

$ oc adm must-gather \
  --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v4.13.11 \
  -- <environment_variable_1> <environment_variable_2> <script_name>

기본 데이터 수집 병렬 프로세스

기본적으로 5개의 프로세스가 병렬로 실행됩니다. 

$ oc adm must-gather \
  --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v4.13.11 \
  -- PROS=5 /usr/bin/gather
1
1
기본값을 변경하여 병렬 프로세스 수를 수정할 수 있습니다.

자세한 VM 정보

다음 명령은 my namespace 네임스페이스 에서 my-vm VM에 대한 자세한 VM 정보를 수집합니다. 

$ oc adm must-gather \
  --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v4.13.11 \
  -- NS=mynamespace VM=my-vm /usr/bin/gather --vms_details
1
1
VM 환경 변수를 사용하는 경우 NS 환경 변수가 필요합니다.

image, image-stream 및 image-stream-tags 정보

다음 명령은 클러스터에서 이미지, 이미지 스트림 및 image-stream-tags 정보를 수집합니다. 

$ oc adm must-gather \
  --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v4.13.11 \
  /usr/bin/gather --images
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

Legal Notice

Theme

© 2026 Red Hat맨 위로 이동