1.17. must-gather 명령을 실행하여 문제 해결
must-gather
명령을 실행하여 세부 정보, 로그 및 디버깅 문제 단계를 수집합니다. 이 디버깅 정보는 지원 요청을 열 때 유용합니다. oc adm must-gather
CLI 명령은 다음을 포함하여 문제를 디버깅하는 데 종종 필요한 정보를 클러스터에서 수집합니다.
- 리소스 정의
- 서비스 로그
1.17.1. 사전 요구 사항
must-gather
명령을 실행하려면 다음 사전 요구 사항을 충족해야 합니다.
-
cluster-admin
역할의 사용자로 글로벌 허브 및 관리 허브 클러스터에 액세스할 수 있습니다. - OpenShift Container Platform CLI(oc)가 설치되어 있어야 합니다.
1.17.2. must-gather 명령 실행
must-gather 명령을 사용하여 정보를 수집하려면 다음 절차를 완료합니다.
-
must-gather
명령에 대해 알아보고 OpenShift Container Platform 설명서에서 클러스터에 대한 데이터 수집 데이터를 읽고 필요한 사전 요구 사항을 설치합니다. 글로벌 허브 클러스터에 로그인합니다. 일반적인 사용 사례는 글로벌 허브 클러스터에 로그인하는 동안 다음 명령을 실행합니다.
oc adm must-gather --image=quay.io/stolostron/must-gather:SNAPSHOTNAME
관리 허브 클러스터를 확인하려면 해당 클러스터에서
must-gather
명령을 실행합니다.선택 사항:
SOMENAME
디렉터리에 결과를 저장하려면 이전 단계의 명령 대신 다음 명령을 실행할 수 있습니다.oc adm must-gather --image=quay.io/stolostron/must-gather:SNAPSHOTNAME --dest-dir=<SOMENAME> ; tar -cvzf <SOMENAME>.tgz <SOMENAME>
디렉터리의 다른 이름을 지정할 수 있습니다.
참고: 이 명령에는 gzipped tarball 파일을 만드는 데 필요한 추가 기능이 포함되어 있습니다.
must-gather
명령에서 다음 정보가 수집됩니다.
-
두 개의 피어 수준:
cluster-scoped-resources
및namespace
resources. - 각 하위 수준: 클러스터 범위 및 네임스페이스 범위 리소스 모두에 대한 사용자 정의 리소스 정의에 대한 API 그룹입니다.
- 각 YAML 파일의 다음 수준: 종류별로 정렬됩니다.
-
글로벌 허브 클러스터의 경우
네임스페이스
리소스에서PostgresCluster
및Kafka
를 확인할 수 있습니다. -
글로벌 허브 클러스터의 경우 다중 클러스터 글로벌 허브 관련 Pod를 확인하고
네임스페이스
리소스의Pod
에서 로그를 확인할 수 있습니다. -
관리 허브 클러스터의 경우 다중 클러스터 글로벌 허브 에이전트 Pod를 확인하고
네임스페이스
리소스의Pod
에 로그인할 수 있습니다.