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를 구성합니다.
  • 영향을 받는 노드 및 가상 머신의 정확한 수를 기록합니다.

절차

  1. 기본 must-gather 이미지를 사용하여 클러스터의 must-gather 데이터를 수집합니다.
  2. 필요한 경우 Red Hat OpenShift Container Storage의 must-gather 데이터를 수집합니다.
  3. OpenShift Virtualization must-gather 이미지를 사용하여 OpenShift Virtualization의 must-gather 데이터를 수집합니다.
  4. 클러스터에 대한 Prometheus 지표를 수집합니다.

13.9.1.1. 추가 리소스

13.9.2. 가상 머신에 대한 데이터 수집

가상 머신 장애 복구(VM)에 대한 데이터를 수집하면 근본 원인을 분석하고 결정하는 데 필요한 시간이 최소화됩니다.

사전 요구 사항

  • Windows VM:

    • Red Hat 지원에 대한 Windows 패치 업데이트 세부 정보를 기록합니다.
    • VirtIO 드라이버의 최신 버전을 설치합니다. VirtIO 드라이버에는 QEMU 게스트 에이전트가 포함되어 있습니다.
    • RDP(Remote Desktop Protocol)가 활성화된 경우, RDP를 사용하여 VM에 연결하여 연결 소프트웨어에 문제가 있는지 확인합니다.

절차

  1. VM 손상에 대한 자세한 must-gather 데이터를 수집합니다.
  2. 재시작하기 전에 충돌한 VM의 스크린샷을 수집합니다.
  3. VM이 손상되는 요인을 기록하십시오. 예를 들어 VM에는 동일한 호스트 또는 네트워크가 있습니다.

13.9.2.1. 추가 리소스

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 세부 정보를 포함하여 가상 머신 정보를 수집합니다. VirtualMachineVirtualMachineInstance 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. 사용법 및 예

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

표 13.1. 호환 매개변수
스크립트호환 가능한 환경 변수

gather_vms_details

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

수집

  • 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: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

13.9.3.2. 추가 리소스

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

© 2024 Red Hat, Inc.