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로 시작).
Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

© 2024 Red Hat, Inc.