2장. must-gather를 사용하여 로그 파일 및 진단 정보 다운로드
Red Hat OpenShift Data Foundation이 문제를 자동으로 해결할 수 없는 경우 must-gather
툴을 사용하여 로그 파일 및 진단 정보를 수집하여 귀하 또는 Red Hat 지원팀이 문제를 검토하고 솔루션을 결정할 수 있도록 합니다.
Red Hat OpenShift Data Foundation이 외부 모드로 배포되는 경우 must-gather
는 OpenShift Data Foundation 클러스터에서만 로그를 수집하고 외부 Red Hat Ceph Storage 클러스터에서 디버그 데이터 및 로그를 수집하지 않습니다. 외부 Red Hat Ceph Storage 클러스터에서 디버그 로그를 수집하려면 Red Hat Ceph Storage 문제 해결 가이드를 참조하십시오. Red Hat Ceph Storage 관리자에게 문의하십시오.
사전 요구 사항
선택 사항: OpenShift Data Foundation이 연결이 끊긴 환경에 배포된 경우 연결이 끊긴 환경에서 사용 가능한 미러 레지스트리에 개별
must-gather
이미지를 미러링해야 합니다.$ oc image mirror registry.redhat.io/odf4/odf-must-gather-rhel9:v4.16 <local-registry>/odf4/odf-must-gather-rhel9:v4.16 [--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 솔루션을 참조하십시오.
프로세스
OpenShift Data Foundation 클러스터에 연결된 클라이언트에서
must-gather
명령을 실행합니다.$ oc adm must-gather --image=registry.redhat.io/odf4/odf-must-gather-rhel9:v4.16 --dest-dir=<directory-name>
<directory-name>
데이터를 작성할 디렉터리의 이름입니다.
중요연결이 끊긴 환경 배포의 경우
--image
매개변수의 이미지를 미러링된must-gather
이미지로 교체합니다.$ oc adm must-gather --image=<local-registry>/odf4/odf-must-gather-rhel9:v4.16 --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 명령의 출력입니다.
2.1. must-gather-commands의 변형
하나 이상의 마스터 노드가 Ready 상태가 아닌 경우
--node-name
을 사용하여must-gather
Pod를 안전하게 예약할 수 있도록 Ready 인 마스터 노드를 제공합니다.$ oc adm must-gather --image=registry.redhat.io/odf4/odf-must-gather-rhel9:v4.16 --dest-dir=_<directory-name>_ --node-name=_<node-name>_
특정 시간에서 정보를 수집하려는 경우:
수집된 로그의 상대 기간(예: 5초 또는 2일 이내)을 지정하려면=<
duration> 이후 /usr/bin/gather
를 추가합니다.$ oc adm must-gather --image=registry.redhat.io/odf4/odf-must-gather-rhel9:v4.16 --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/odf-must-gather-rhel9:v4.16 --dest-dir=_<directory-name>_ /usr/bin/gather since-time=<rfc3339-timestamp>
다음 명령에서 예제 값을 다음과 같이 바꿉니다.
- <node-name>
-
하나 이상의 마스터 노드가 Ready 상태에 있지 않은 경우 이 매개 변수를 사용하여 여전히 Ready 상태에 있는 마스터 노드의 이름을 제공합니다. 이렇게 하면
must-gather
Pod가 준비되지 않은 마스터 노드에서 예약되지 않도록 하여 예약 오류가 발생하지 않습니다. - <directory-name>
-
must-gather
에서 수집하는 정보를 저장할 디렉터리입니다. - <duration>
-
정보를 상대 기간(예:
5
시간 전)으로 수집할 시간을 지정합니다. - <rfc3339-timestamp>
-
에서 정보를 RFC 3339 타임스탬프로 수집할 시간을 지정합니다(예:
2020-11-10T04:00:00+00:00
(2020년 11월 11일 UTC로 시작).