14.2. Red Hat 지원을 위한 데이터 수집
Red Hat 지원에 지원 케이스 를 제출할 때 다음 툴을 사용하여 OpenShift Container Platform 및 OpenShift Virtualization에 대한 디버깅 정보를 제공하는 것이 좋습니다.
- must-gather 툴
-
must-gather
툴은 리소스 정의 및 서비스 로그를 포함한 진단 정보를 수집합니다. - Prometheus
- Prometheus는 시계열 데이터베이스이며 메트릭에 대한 규칙 평가 엔진입니다. Prometheus는 처리를 위해 Alertmanager에 경고를 보냅니다.
- Alertmanager
- Alertmanager 서비스는 Prometheus에서 수신한 경고를 처리합니다. 또한 Alertmanager는 경고를 외부 알림 시스템으로 전송합니다.
OpenShift Container Platform 모니터링 스택에 대한 자세한 내용은 OpenShift Container Platform 모니터링 정보를 참조하십시오.
14.2.1. 환경에 대한 데이터 수집
환경에 대한 데이터를 수집하면 근본 원인을 분석하고 결정하는 데 필요한 시간이 최소화됩니다.
사전 요구 사항
- Prometheus 지표 데이터의 보존 시간을 최소 7일로 설정합니다.
- 관련 경고를 캡처하고 클러스터 외부에서 보고 유지할 수 있도록 전용box에 경고 알림을 전송하도록 Alertmanager를 구성합니다.
- 영향을 받는 노드와 가상 머신의 정확한 수를 기록합니다.
14.2.2. 가상 머신에 대한 데이터 수집
VM(가상 머신)에 대한 데이터를 수집하면 근본 원인을 분석하고 결정하는 데 필요한 시간이 최소화됩니다.
사전 요구 사항
- Linux VM: 최신 QEMU 게스트 에이전트를 설치합니다.
Windows VM:
- Windows 패치 업데이트 세부 정보를 기록합니다.
- 최신 VirtIO 드라이버를 설치합니다.
- 최신 QEMU 게스트 에이전트를 설치합니다.
- RDP(원격 데스크탑 프로토콜)가 활성화된 경우 웹 콘솔 또는 명령줄 을 사용하여 RDP가 있는 VM에 연결하여 연결 소프트웨어에 문제가 있는지 확인합니다.
절차
-
/usr/bin/ gather 스크립트를 사용하여 VM의 must-gather 데이터를 수집합니다
. - 다시 시작하기 전에 충돌한 VM의 스크린샷을 수집합니다.
- 해결 시도 전에 VM에서 메모리 덤프를 수집합니다.
- 가상 머신의 공통 요인을 기록합니다. 예를 들어 VM은 동일한 호스트 또는 네트워크를 갖습니다.
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. 사용 및 예
환경 변수는 선택 사항입니다. 호환 가능한 하나 이상의 환경 변수를 사용하여 단독으로 또는 하나 이상의 스크립트를 실행할 수 있습니다.
스크립트 | 호환 가능한 환경 변수 |
---|---|
|
|
|
|
|
|
구문
$ 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