13.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 모니터링 정보를 참조하십시오.
13.2.1. 환경에 대한 데이터 수집
환경에 대한 데이터를 수집하면 근본 원인을 분석하고 결정하는 데 필요한 시간이 최소화됩니다.
사전 요구 사항
- Prometheus 지표 데이터의 보존 시간을 최소 7일로 설정합니다.
- 관련 경고를 캡처하고 클러스터 외부에서 보고 유지할 수 있도록 전용box에 경고 알림을 전송하도록 Alertmanager를 구성합니다.
- 영향을 받는 노드 및 가상 머신의 정확한 수를 기록합니다.
13.2.2. 가상 머신에 대한 데이터 수집
VM(가상 머신)의 오작동에 대한 데이터를 수집하면 근본 원인을 분석하고 결정하는 데 필요한 시간이 최소화됩니다.
사전 요구 사항
- Linux VM: 최신 QEMU 게스트 에이전트를 설치합니다.
Windows VMs:
- Windows 패치 업데이트 세부 정보를 기록합니다.
- 최신 VirtIO 드라이버를 설치합니다.
- 최신 QEMU 게스트 에이전트를 설치합니다.
- RDP(원격 데스크탑 프로토콜)가 활성화된 경우 데스크탑 뷰어를 사용하여 연결하여 연결 소프트웨어에 문제가 있는지 확인합니다.
프로세스
-
/usr/bin/ gather 스크립트를 사용하여 VM의 must-gather 데이터를 수집합니다. - 재시작 하기 전에 충돌한 VM의 스크린샷을 수집합니다.
- 해결 시도 전에 VM에서 메모리 덤프를 수집합니다.
- 오작동하는 VM에 공통된 요인을 기록합니다. 예를 들어 VM에는 동일한 호스트 또는 네트워크가 있습니다.
13.2.3. OpenShift Virtualization에 must-gather 툴 사용
must-gather 명령을 OpenShift Virtualization 이미지로 실행하여 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.15.6 \ -- /usr/bin/gather
13.2.3.1. must-gather 툴 옵션
다음 옵션에 대해 스크립트 및 환경 변수의 조합을 지정할 수 있습니다.
- 네임스페이스에서 자세한 VM(가상 머신) 정보 수집
- 지정된 VM에 대한 자세한 정보 수집
- 이미지, 이미지 스트림 및 image-stream-tags 정보 수집
-
must-gather툴에서 사용하는 최대 병렬 프로세스 수 제한
13.2.3.1.1. 매개 변수
환경 변수
호환되는 스크립트에 대한 환경 변수를 지정할 수 있습니다.
NS=<namespace_name>-
지정한 네임스페이스에서
virt-launcherPod 세부 정보를 포함한 가상 머신 정보를 수집합니다.VirtualMachine및VirtualMachineInstanceCR 데이터는 모든 네임스페이스에 대해 수집됩니다. VM=<vm_name>-
특정 가상 머신에 대한 세부 정보를 수집합니다. 이 옵션을 사용하려면
NS환경 변수를 사용하여 네임스페이스도 지정해야 합니다. PROS=<number_of_processes>must-gather툴에서 사용하는 최대 병렬 프로세스 수를 수정합니다. 기본값은5입니다.중요병렬 프로세스를 너무 많이 사용하면 성능 문제가 발생할 수 있습니다. 최대 병렬 프로세스 수를 늘리는 것은 권장되지 않습니다.
스크립트
각 스크립트는 특정 환경 변수 조합과만 호환됩니다.
/usr/bin/gather-
기본
must-gather스크립트를 사용하여 모든 네임스페이스에서 클러스터 데이터를 수집하고 기본 VM 정보만 포함합니다. 이 스크립트는PROS변수와만 호환됩니다. /usr/bin/gather --vms_details-
VM 로그 파일, VM 정의, 컨트롤 플레인 로그 및 OpenShift Virtualization 리소스에 속하는 네임스페이스를 수집합니다. 네임스페이스를 지정하면 해당 하위 오브젝트가 포함됩니다. 네임스페이스 또는 VM을 지정하지 않고 이 매개변수를 사용하는 경우
must-gather툴에서 클러스터의 모든 VM에 대해 이 데이터를 수집합니다. 이 스크립트는 모든 환경 변수와 호환되지만VM변수를 사용하는 경우 네임스페이스를 지정해야 합니다. /usr/bin/gather --images-
이미지, 이미지 스트림 및 image-stream-tags 사용자 정의 리소스 정보를 수집합니다. 이 스크립트는
PROS변수와만 호환됩니다. /usr/bin/gather --instancetypes- 인스턴스 유형 정보를 수집합니다. 이 정보는 현재 기본적으로 수집되지 않지만 선택적으로 수집할 수 있습니다.
13.2.3.1.2. 사용법 및 예
환경 변수는 선택 사항입니다. 직접 또는 하나 이상의 호환 환경 변수를 사용하여 스크립트를 실행할 수 있습니다.
| 스크립트 | 호환되는 환경 변수 |
|---|---|
|
|
* |
|
|
* 네임스페이스의 경우:
* VM=<
* |
|
|
* |
구문
$ oc adm must-gather \ --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v4.15.6 \ -- <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.15.6 \
-- 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.15.6 \
-- 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.15.6 \ /usr/bin/gather --images
인스턴스 유형 정보
다음 명령은 클러스터에서 인스턴스 유형 정보를 수집합니다.
$ oc adm must-gather \ --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v4.15.6 \ /usr/bin/gather --instancetypes
