4.20. 지원 케이스에 대한 디버깅 데이터 수집

지원 케이스를 여는 경우 클러스터에 대한 디버깅 정보를 Red Hat 지원 팀에 제공해야 합니다. must-gather 툴을 사용하여 프로젝트 수준 리소스, 클러스터 수준 리소스 및 Red Hat OpenShift GitOps 구성 요소에 대한 진단 정보를 수집할 수 있습니다. 

참고

즉각 지원을 받을 수 있도록 OpenShift Container Platform 및 Red Hat OpenShift GitOps 둘 다에 대한 진단 정보를 제공하십시오.

4.20.1. must-gather 툴 정보

oc adm must-gather CLI 명령은 다음을 포함하여 문제를 디버깅하는 데 필요할 가능성이 높은 클러스터에서 정보를 수집합니다.

  • 리소스 정의
  • 서비스 로그

기본적으로 oc adm must-gather 명령은 기본 플러그인 이미지를 사용하고 ./must-gather.local 에 씁니다.

또는 다음 섹션에 설명된 대로 적절한 인수로 명령을 실행하여 특정 정보를 수집할 수 있습니다.

  • 하나 이상의 특정 기능과 관련된 데이터를 수집하려면 다음 섹션에 나열된 대로 이미지와 함께 --image 인수를 사용합니다.

    예를 들면 다음과 같습니다. 

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

  • 감사 로그를 수집하려면 다음 섹션에 설명된 대로 -- /usr/bin/gather_audit_logs 인수를 사용합니다.

    예를 들면 다음과 같습니다. 

    $ oc adm must-gather -- /usr/bin/gather_audit_logs
    참고

    감사 로그는 파일 크기를 줄이기 위해 기본 정보 세트의 일부로 수집되지 않습니다.

oc adm must-gather 를 실행하면 클러스터의 새 프로젝트에 임의의 이름이 있는 새 Pod가 생성됩니다. 해당 Pod에 대한 데이터가 수집되어 must-gather.local로 시작하는 새 디렉터리에 저장됩니다. 이 디렉터리는 현재 작업 중인 디렉터리에 생성되어 있습니다.

예를 들면 다음과 같습니다. 

NAMESPACE                      NAME                 READY   STATUS      RESTARTS      AGE
...
openshift-must-gather-5drcj    must-gather-bklx4    2/2     Running     0             72s
openshift-must-gather-5drcj    must-gather-s8sdh    2/2     Running     0             72s
...

선택적으로 --run-namespace 옵션을 사용하여 특정 네임스페이스에서 oc adm must-gather 명령을 실행할 수 있습니다.

예를 들면 다음과 같습니다. 

$ oc adm must-gather --run-namespace <namespace> \
  --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v4.13.3

4.20.2. Red Hat OpenShift GitOps에 대한 디버깅 데이터 수집

oc adm must-gather CLI 명령을 사용하여 Red Hat OpenShift GitOps와 연결된 클러스터에 대한 다음 세부 정보를 수집합니다.

  • Red Hat OpenShift GitOps Operator의 서브스크립션 및 네임스페이스입니다.
  • ArgoCD 오브젝트가 사용 가능한 네임스페이스 및 ArgoCD,Applications,ApplicationSets,AppProjects 및 configmaps 와 같은 네임스페이스의 오브젝트입니다.
  • Red Hat OpenShift GitOps Operator에서 관리하는 네임스페이스 목록과 해당 네임스페이스의 리소스입니다.
  • 모든 GitOps 관련 사용자 정의 리소스 오브젝트 및 정의
  • Operator 및 Argo CD 로그입니다.
  • 경고 및 오류 수준 이벤트

사전 요구 사항

  • 관리자로 OpenShift Container Platform 클러스터에 로그인했습니다.
  • OpenShift Container Platform CLI(oc)를 설치했습니다.
  • Red Hat OpenShift GitOps Operator가 설치되었습니다.

프로세스

  1. 디버깅 정보를 저장할 디렉터리로 이동합니다.

  2. Red Hat OpenShift GitOps must-gather 이미지를 사용하여 oc adm must-gather 명령을 실행합니다. 

    $ oc adm must-gather --image=registry.redhat.io/openshift-gitops-1/gitops-must-gather-rhel8:v1.9.0

    must-gather 툴은 현재 디렉터리에서 ./must-gather.local 로 시작하는 새 디렉터리를 생성합니다. 예를 들면 ./must-gather.local.4157245944708210399 입니다.

  3. 방금 만든 디렉터리에서 압축 파일을 만듭니다. 예를 들어 Linux 운영 체제를 사용하는 컴퓨터에서 다음 명령을 실행합니다. 

    $ tar -cvaf must-gather.tar.gz must-gather.local.4157245944708210399
  4. Red Hat Customer Portal에서 해당 지원 사례에 압축 파일을 첨부합니다.