2장. must-gather를 사용하여 로그 파일 및 진단 정보 다운로드

사전 요구 사항

• 선택 사항: OpenShift Data Foundation이 연결이 끊긴 환경에 배포된 경우 연결이 끊긴 환경에서 사용 가능한 미러 레지스트리에 개별 must-gather 이미지를 미러링해야 합니다.

  $ oc image mirror registry.redhat.io/odf4/ocs-must-gather-rhel8:v4.9 <local-registry>/odf4/ocs-must-gather-rhel8:v4.9 [--registry-config=<path-to-the-registry-config>] [--insecure=true]

  <local-registry>

  연결이 끊긴 OpenShift Container Platform 클러스터에 사용 가능한 로컬 이미지 미러 레지스트리입니다.

  <path-to-the-registry-config>

  기본적으로 레지스트리 인증 정보의 경로는 ~/.docker/config.json 입니다.

  --insecure

  미러 레지스트리가 안전하지 않은 경우에만 이 플래그를 추가합니다.

  자세한 내용은 Red Hat Knowledgebase 솔루션을 참조하십시오.

  • Redhat Openshift 레지스트리 간 이미지를 미러링하는 방법
  • 프라이빗 레지스트리가 안전하지 않은 경우 OpenShift 이미지 저장소를 미러링하지 못했습니다.

절차

• Red Hat OpenShift Data Foundation 클러스터에 연결된 클라이언트에서 must-gather 명령을 실행합니다.

  $ oc adm must-gather --image=registry.redhat.io/odf4/ocs-must-gather-rhel8:v4.9 --dest-dir=<directory-name>

  <directory-name>

  데이터를 쓸 디렉터리의 이름입니다.

  중요

  연결이 끊긴 환경 배포의 경우 --image 매개변수의 이미지를 미러링된 must-gather 이미지로 교체합니다.

  $ oc adm must-gather --image=<local-registry>/odf4/ocs-must-gather-rhel8:v4.9 --dest-dir=<directory-name>

  <local-registry>

  연결이 끊긴 OpenShift Container Platform 클러스터에 사용 가능한 로컬 이미지 미러 레지스트리입니다.

  이렇게 하면 지정된 디렉터리에서 다음 정보가 수집됩니다.

  • 모든 Red Hat OpenShift Data Foundation 클러스터 관련 CR(사용자 정의 리소스) 및 해당 네임스페이스.
  • 모든 Red Hat OpenShift Data Foundation 관련 Pod의 Pod 로그입니다.
  • Status, Cluster 상태 등 일부 표준 Ceph 명령의 출력입니다.

명령 변경

• 하나 이상의 마스터 노드가 Ready 상태가 아닌 경우 --node-name 을 사용하여 must-gather Pod를 안전하게 예약할 수 있도록 준비된 마스터 노드를 제공하십시오.

  $ oc adm must-gather --image=registry.redhat.io/odf4/ocs-must-gather-rhel8:v4.9 --dest-dir=<directory-name> --node-name=<node-name>

• 특정 시간에서 정보를 수집하려면 다음을 수행합니다.

  • 수집된 로그의 상대적 기간을 5일 또는 2일 이내에 지정하려면 =<duration> 이후 /usr/bin/gather 를 추가합니다.

    $ oc adm must-gather --image=registry.redhat.io/odf4/ocs-must-gather-rhel8:v4.9 --dest-dir=<directory-name> /usr/bin/gather since=<duration>

  • 로그를 수집할 특정 시간을 지정하려면 /usr/bin/gather since-time=<rfc3339-timestamp> 를 추가합니다.

    $ oc adm must-gather --image=registry.redhat.io/odf4/ocs-must-gather-rhel8:v4.9 --dest-dir=<directory-name> /usr/bin/gather since-time=<rfc3339-timestamp>

  이 명령의 예제 값을 다음과 같이 바꿉니다.

  <node-name>

  하나 이상의 마스터 노드가 Ready 상태가 아닌 경우 이 매개변수를 사용하여 아직 Ready 상태에 있는 마스터 노드의 이름을 제공합니다. 이렇게 하면 준비되지 않은 마스터 노드에서 must-gather Pod가 예약되지 않도록 하여 예약 오류가 발생하지 않습니다.

  <directory-name>

  must-gather 에서 수집한 정보를 저장할 디렉터리입니다.

  <duration>

  정보 수집 기간을 상대적 기간(예: 5시간 전) 5h 로 지정합니다.

  <rfc3339-timestamp>

  정보 수집 기간을 RFC 3339 타임 스탬프 (예: 2020-11-10T04:00:00 +00+00) (2020년 11월 11일 오전 4시부터 시작)로 지정합니다.