13.9. Red Hat 지원을 위한 데이터 수집
Red Hat 지원에 지원 케이스 를 제출할 때 다음 툴을 사용하여 OpenShift Container Platform 및 OpenShift Virtualization에 대한 디버깅 정보를 제공하는 것이 좋습니다.
- must-gather 툴
-
must-gather
툴은 리소스 정의 및 서비스 로그를 포함하여 진단 정보를 수집합니다. - Prometheus
- Prometheus는 시계열 데이터베이스이며 메트릭에 대한 규칙 평가 엔진입니다. Prometheus는 처리를 위해 Alertmanager에 경고를 보냅니다.
- Alertmanager
- Alertmanager 서비스는 Prometheus에서 수신한 경고를 처리합니다. Alertmanager는 또한 외부 알림 시스템으로 경고를 보냅니다.
13.9.1. 환경에 대한 데이터 수집
환경에 대한 데이터를 수집하면 근본 원인을 분석하고 결정하는 데 필요한 시간이 최소화됩니다.
사전 요구 사항
- Prometheus 지표 데이터의 보존 시간을 최소 7일로 설정합니다.
- 관련 경고를 캡처하고 클러스터 외부에서 보고 유지할 수 있도록 전용 메일로 전송하도록 Alertmanager를 구성합니다.
- 영향을 받는 노드 및 가상 머신의 정확한 수를 기록합니다.
절차
-
기본
must-gather
이미지를 사용하여 클러스터의must-gather
데이터를 수집합니다. -
필요한 경우 Red Hat OpenShift Container Storage의
must-gather
데이터를 수집합니다. -
OpenShift Virtualization
must-gather
이미지를 사용하여 OpenShift Virtualization의must-gather
데이터를 수집합니다. - 클러스터에 대한 Prometheus 지표를 수집합니다.
13.9.1.1. 추가 리소스
- Prometheus 메트릭 데이터의 보존 시간 구성
- 외부 시스템에 경고 알림을 전송하도록 Alertmanager 구성
-
OpenShift Container Platform의
must-gather
데이터 수집 -
OpenShift Virtualization의
must-gather
데이터 수집 - 클러스터 관리자로 모든 프로젝트의 Prometheus 지표 수집
13.9.2. 가상 머신에 대한 데이터 수집
가상 머신 장애 복구(VM)에 대한 데이터를 수집하면 근본 원인을 분석하고 결정하는 데 필요한 시간이 최소화됩니다.
사전 요구 사항
Windows VM:
- Red Hat 지원에 대한 Windows 패치 업데이트 세부 정보를 기록합니다.
- VirtIO 드라이버의 최신 버전을 설치합니다. VirtIO 드라이버에는 QEMU 게스트 에이전트가 포함되어 있습니다.
- RDP(Remote Desktop Protocol)가 활성화된 경우, RDP를 사용하여 VM에 연결하여 연결 소프트웨어에 문제가 있는지 확인합니다.
절차
-
VM 손상에 대한 자세한
must-gather
데이터를 수집합니다. - 재시작하기 전에 충돌한 VM의 스크린샷을 수집합니다.
- VM이 손상되는 요인을 기록하십시오. 예를 들어 VM에는 동일한 호스트 또는 네트워크가 있습니다.
13.9.2.1. 추가 리소스
- Windows VM에 VirtIO 드라이버 설치
- 호스트 액세스없이 Windows VM에 VirtIO 드라이버 다운로드 및 설치
- 웹 콘솔 또는 명령줄을 사용하여 RDP로 Windows VM에 연결
-
가상 머신에대한
must-gather
데이터 수집
13.9.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}
13.9.3.1. must-gather 툴 옵션
다음 옵션에 대한 스크립트 및 환경 변수 조합을 지정할 수 있습니다.
- 네임스페이스에서 자세한 VM(가상 머신) 정보 수집
- 지정된 VM에 대한 세부 정보 수집
- 이미지 및 이미지 스트림 정보 수집
-
must-gather
툴에서 사용하는 최대 병렬 프로세스 수 제한
13.9.3.1.1. 매개 변수
환경 변수
호환되는 스크립트의 환경 변수를 지정할 수 있습니다.
NS=<namespace_name>
-
지정하는 네임스페이스에서
virt-launcher
Pod 세부 정보를 포함하여 가상 머신 정보를 수집합니다.VirtualMachine
및VirtualMachineInstance
CR 데이터는 모든 네임스페이스에 대해 수집됩니다. VM=<vm_name>
-
특정 가상 머신에 대한 세부 정보를 수집합니다. 이 옵션을 사용하려면
NS
환경 변수를 사용하여 네임스페이스를 지정해야 합니다. PROS=<number_of_processes>
must-gather
툴에서 사용하는 최대 병렬 프로세스 수를 수정합니다. 기본값은5
입니다.중요병렬 프로세스를 너무 많이 사용하면 성능 문제가 발생할 수 있습니다. 최대 병렬 프로세스 수를 늘리는 것은 권장되지 않습니다.
스크립트
각 스크립트는 특정 환경 변수 조합과만 호환됩니다.
gather_vms_details
-
OpenShift Virtualization 리소스에 속하는 VM 로그 파일, VM 정의 및 네임스페이스(및 해당 하위 오브젝트)를 수집합니다. 네임스페이스 또는 VM을 지정하지 않고 이 매개변수를 사용하는 경우
must-gather
툴은 클러스터의 모든 VM에 대해 이 데이터를 수집합니다. 이 스크립트는 모든 환경 변수와 호환되지만VM
변수를 사용하는 경우 네임스페이스를 지정해야 합니다. 수집
-
모든 네임스페이스에서 클러스터 데이터를 수집하고 기본 VM 정보만 포함하는 기본
must-gather
스크립트를 사용합니다. 이 스크립트는PROS
변수와만 호환됩니다. gather_images
-
이미지 및 이미지 스트림 사용자 정의 리소스 정보를 수집합니다. 이 스크립트는
PROS
변수와만 호환됩니다.
13.9.3.1.2. 사용법 및 예
환경 변수는 선택 사항입니다. 자체적으로 또는 하나 이상의 호환 환경 변수를 사용하여 스크립트를 실행할 수 있습니다.
스크립트 | 호환 가능한 환경 변수 |
---|---|
|
|
|
|
|
|
must-gather
가 수집하는 데이터를 사용자 정의하려면 명령에 이중 대시 (--
)를 추가한 다음 공백 및 하나 이상의 호환 가능한 매개변수를 추가합니다.
구문
$ oc adm must-gather \ --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel8:v4.8.7 \ -- <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:v4.8.7 \
-- NS=mynamespace VM=my-vm gather_vms_details 1
- 1
VM
환경 변수를 사용하는 경우NS
환경 변수는 필수입니다.
세 개의 병렬 프로세스로 제한되는 기본 데이터 수집
다음 명령은 최대 3개의 병렬 프로세스를 사용하여 기본 must-gather
정보를 수집합니다.
$ oc adm must-gather \ --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel8:v4.8.7 \ -- PROS=3 gather
이미지 및 이미지 스트림 정보
다음 명령은 클러스터에서 이미지 및 이미지 스트림 정보를 수집합니다.
$ oc adm must-gather \ --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel8:v4.8.7 \ -- gather_images