Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

5.2. 지원 로그 수집 정보

Log Gather Operator는 디버깅 데이터 수집을 자동화하기 위해 기존 must-gather 툴의 기능을 기반으로 합니다. 수집된 정보를 단일 .tar 파일에 패키징하고 지정된 Red Hat 지원 케이스에 자동으로 업로드하여 문제 해결을 간소화합니다.

중요

지원 로그 수집은 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

지원 로그 수집의 주요 기능은 다음과 같습니다.

  • 관리자 권한이 필요 없음: 승격된 권한 없이도 로그를 수집하고 업로드할 수 있으므로 관리자가 아닌 사용자가 데이터를 안전하게 수집할 수 있습니다.
  • 간소화된 로그 수집: 리소스 정의 및 서비스 로그와 같은 클러스터에서 디버깅 데이터를 수집합니다.
  • 구성 가능한 데이터 업로드: .tar 파일을 지원 케이스에 자동으로 업로드하거나 수동 업로드를 위해 로컬로 저장할 수 있는 구성 옵션을 제공합니다.

5.2.1. 웹 콘솔을 사용하여 지원 로그 수집 설치
링크 복사

웹 콘솔을 사용하여 Support Log Gather를 설치할 수 있습니다.

중요

지원 로그 수집은 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

사전 요구 사항

  • cluster-admin 권한이 있는 클러스터에 액세스할 수 있습니다.
  • OpenShift Container Platform 웹 콘솔에 액세스할 수 있습니다.

프로세스

  1. OpenShift Container Platform 웹 콘솔에 로그인합니다.
  2. 에코시스템 소프트웨어 카탈로그 로 이동합니다.
  3. 필터 상자에 Support Log Gather 를 입력합니다.
  4. Support Log Gather 를 선택합니다.
  5. 버전 목록에서 지원 로그 수집 버전을 선택하고 설치를 클릭합니다.

  6. Operator 설치 페이지에서 설치 설정을 구성합니다.

    1. Operator의 설치된 네임스페이스 를 선택합니다.

      기본 Operator 네임스페이스는 must-gather-operator 입니다. must-gather-operator 네임스페이스가 없는 경우 자동으로 생성됩니다.

    2. 업데이트 승인 전략을 선택합니다.

      • 최신 버전이 사용 가능할 때 OLM(Operator Lifecycle Manager)에서 Operator를 자동으로 업데이트하려면 Automatic 을 선택합니다.
      • 적절한 인증 정보가 있는 사용자가 Operator 업데이트를 승인해야 하는 경우 Manual 을 선택합니다.
    3. 설치를 클릭합니다.

검증

  1. Operator가 성공적으로 설치되었는지 확인합니다.

    1. 에코시스템 소프트웨어 카탈로그 로 이동합니다.
    2. must-gather-operator 네임스페이스에 상태 Succeeded 로 지원 로그 가 나열되어 있는지 확인합니다.

  2. 지원 로그 수집 Pod가 실행 중인지 확인합니다.

    1. 워크로드 Pod로 이동합니다.

    2. Support Log Gather Pod의 상태가 Running 인지 확인합니다.

      Pod가 가동되어 실행된 후에만 지원 로그 Gather를 사용할 수 있습니다.

5.2.2. CLI를 사용하여 지원 로그 수집 설치
링크 복사

지원 케이스에 대한 자동화된 로그 수집을 활성화하려면 CLI(명령줄 인터페이스)에서 Support Log Gather를 설치할 수 있습니다.

중요

지원 로그 수집은 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

사전 요구 사항

  • cluster-admin 권한이 있는 클러스터에 액세스할 수 있습니다.

프로세스

  1. 다음 명령을 실행하여 must-gather-operator 라는 새 프로젝트를 생성합니다. 

    $ oc new-project must-gather-operator
    Copy to Clipboard Toggle word wrap

  2. OperatorGroup 오브젝트를 생성합니다.

    1. OperatorGroup 오브젝트를 정의하는 YAML 파일(예: operatorGroup.yaml )을 생성합니다. 

      apiVersion: operators.coreos.com/v1
kind: OperatorGroup
metadata:
  name: must-gather-operator
  namespace: must-gather-operator
spec: {}
      Copy to Clipboard Toggle word wrap

    2. 다음 명령을 실행하여 OperatorGroup 오브젝트를 생성합니다. 

      $ oc create -f operatorGroup.yaml
      Copy to Clipboard Toggle word wrap

  3. Subscription 오브젝트를 생성합니다.

    1. Subscription 오브젝트를 정의하는 YAML 파일(예: subscription.yaml )을 생성합니다. 

      apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: support-log-gather-operator
  namespace: must-gather-operator
spec:
  channel: tech-preview
  name: support-log-gather-operator
  source: redhat-operators
  sourceNamespace: openshift-marketplace
  installPlanApproval: Automatic
      Copy to Clipboard Toggle word wrap

    2. 다음 명령을 실행하여 서브스크립션 오브젝트를 생성합니다. 

      $ oc create -f subscription.yaml
      Copy to Clipboard Toggle word wrap

검증

  1. 다음 명령을 실행하여 Operator 네임스페이스에서 Pod의 상태를 확인합니다. 

    $ oc get pods
    Copy to Clipboard Toggle word wrap

    출력 예

    NAME                                                              READY   STATUS      RESTARTS   AGE
must-gather-operator-657fc74d64-2gg2w                             1/1     Running     0          13m
    Copy to Clipboard Toggle word wrap

    모든 Pod의 상태는 Running 이어야 합니다.

  2. 다음 명령을 실행하여 서브스크립션이 생성되었는지 확인합니다. 

    $ oc get subscription -n must-gather-operator
    Copy to Clipboard Toggle word wrap

    출력 예

    NAME                          PACKAGE                       SOURCE            CHANNEL
support-log-gather-operator   support-log-gather-operator   redhat-operators  tech-preview
    Copy to Clipboard Toggle word wrap

  3. 다음 명령을 실행하여 Operator가 설치되었는지 확인합니다. 

    $ oc get csv -n must-gather-operator
    Copy to Clipboard Toggle word wrap

    출력 예

    NAME                                  DISPLAY                VERSION   REPLACES   PHASE
support-log-gather-operator.v4.20.0   support log gather     4.20.0               Succeeded
    Copy to Clipboard Toggle word wrap

5.2.3. 지원 로그 수집 인스턴스 구성
링크 복사

클러스터에서 진단 데이터 수집을 자동화하려면 CLI(명령줄 인터페이스)에서 MustGather CR(사용자 정의 리소스)을 생성해야 합니다. 또한 이 프로세스는 Red Hat 지원 케이스에 데이터를 자동으로 업로드합니다.

중요

지원 로그 수집은 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

사전 요구 사항

  • OpenShift CLI(oc) 툴을 설치했습니다.
  • 클러스터에 Support Log Gather가 설치되어 있습니다.
  • Red Hat 지원 케이스 ID가 있습니다.
  • Red Hat 고객 포털 인증 정보가 포함된 Kubernetes 시크릿을 생성했습니다. 시크릿에는 사용자 이름 필드와 암호 필드가 포함되어야 합니다.
  • 서비스 계정을 생성했습니다.

프로세스

  1. 다음 기본 구성이 포함된 support-log-gather.yaml 과 같은 MustGather CR의 YAML 파일을 생성합니다.

    support-log-gather.yaml예

    apiVersion: operator.openshift.io/v1alpha1
kind: MustGather
metadata:
  name: example-mg
  namespace: must-gather-operator
spec:
  serviceAccountName: must-gather-operator
  audit: true
  proxyConfig:
    httpProxy: "http://proxy.example.com:8080"
    httpsProxy: "https://proxy.example.com:8443"
    noProxy: ".example.com,localhost"
  mustGatherTimeout: "1h30m9s"
  uploadTarget:
    type: SFTP
    sftp:
      caseID: "04230315"
      caseManagementAccountSecretRef:
        name: mustgather-creds
      host: "sftp.access.redhat.com"
  retainResourcesOnCompletion: true
  storage:
    type: PersistentVolume
    persistentVolume:
      claim:
        name: mustgather-pvc
      subPath: must-gather-bundles/case-04230315
    Copy to Clipboard Toggle word wrap

    구성 매개변수에 대한 자세한 내용은 " MustGather 사용자 정의 리소스에 대한 구성 매개변수"를 참조하십시오.

  2. 다음 명령을 실행하여 MustGather 오브젝트를 생성합니다. 

    $ oc create -f support-log-gather.yaml
    Copy to Clipboard Toggle word wrap

검증

  1. 다음 명령을 실행하여 MustGather CR이 생성되었는지 확인합니다. 

    $ oc get mustgather
    Copy to Clipboard Toggle word wrap

    출력 예

    NAME          AGE
example-mg    7s
    Copy to Clipboard Toggle word wrap

  2. 다음 명령을 실행하여 Operator 네임스페이스에서 Pod의 상태를 확인합니다. 

    $ oc get pods
    Copy to Clipboard Toggle word wrap

    출력 예

    NAME                                                              READY   STATUS      RESTARTS   AGE
must-gather-operator-657fc74d64-2gg2w                             1/1     Running     0          13m
example-mg-gk8m8                                                  2/2     Running     0          13s
    Copy to Clipboard Toggle word wrap

    MustGather CR을 기반으로 하는 이름이 있는 새 Pod를 생성해야 합니다. 모든 Pod의 상태는 Running 이어야 합니다.

  3. 파일 업로드 진행 상황을 모니터링하려면 다음 명령을 실행하여 작업 Pod에서 업로드 컨테이너의 로그를 확인합니다. 

    oc logs -f pod/example-mg-gk8m8 -c upload
    Copy to Clipboard Toggle word wrap

    성공적으로 수행되면 프로세스에서 아카이브를 생성하여 지정된 케이스에 대해 Red Hat STS(Secure File Transfer Protocol) 서버에 업로드해야 합니다.

5.2.4. MustGather 사용자 정의 리소스에 대한 구성 매개변수
링크 복사

데이터 수집 및 업로드 프로세스를 지정하는 YAML 파일을 생성하여 MustGather CR(사용자 정의 리소스)을 관리할 수 있습니다. 다음 표에서는 MustGather CR에서 구성할 수 있는 매개변수에 대한 개요를 제공합니다.

Expand
매개변수 이름설명유형

spec.audit

선택 사항: 감사 로그를 수집할지 여부를 지정합니다. 유효한 값은 true 및 false 입니다. 기본값은 false입니다.

boolean

spec.mustGatherTimeout

선택 사항: must-gather 명령을 완료하는 데 필요한 시간 제한을 지정합니다.

값은 시간 단위가 있는 부동 소수점 숫자여야 합니다. 유효한 단위는 s (초), m (분) 또는 h (시간)입니다. 기본적으로 시간은 제한으로 설정되어 있지 않습니다.

spec.proxyConfig

선택 사항: 사용할 프록시 구성을 정의합니다. 기본값은 클러스터 수준 프록시 구성으로 설정됩니다.

개체

spec.proxyConfig.httpProxy

HTTP 요청에 대한 프록시의 URL을 지정합니다.

URL

spec.proxyConfig.httpsProxy

HTTPS 요청의 프록시 URL을 지정합니다.

 

spec.proxyConfig.noProxy

프록시를 사용하지 않아야 하는 쉼표로 구분된 도메인 목록을 지정합니다.

URL 목록

spec.retainResourcesOnCompletion

선택 사항: 데이터 수집 완료 후 must-gather 작업 및 관련 리소스를 유지할지 여부를 지정합니다. 유효한 값은 true 및 false 입니다. 기본값은 false입니다.

boolean

spec.serviceAccountName

선택 사항: 서비스 계정의 이름을 지정합니다. 기본값은 default입니다.

string

spec.storage

선택 사항: must-gather 번들에 대한 스토리지 구성을 정의합니다.

개체

spec.storage.persistentVolume

영구 볼륨의 세부 정보를 정의합니다.

개체

spec.storage.persistentVolume.claim

PVC(영구 볼륨 클레임)의 세부 정보를 정의합니다.

개체

spec.storage.persistentVolume.claim.name

스토리지에 사용할 PVC의 이름을 지정합니다.

string

spec.storage.persistentVolume.subPath

선택 사항: 번들을 저장할 PVC 내의 경로를 지정합니다.

string

spec.storage.type

스토리지 유형을 정의합니다. 지원되는 유일한 값은 PersistentVolume 입니다.

string

spec.uploadTarget

선택 사항: must-gather 번들의 업로드 위치를 정의합니다.

개체

spec.uploadTarget.host

선택 사항: 번들 업로드를 위한 대상 서버를 지정합니다. 기본적으로 번들은 sftp.access.redhat.com 에 업로드됩니다.

기본적으로 번들은 sftp.access.redhat.com 에 업로드됩니다.

spec.uploadTarget.sftp.caseID

진단 데이터가 수집되는 Red Hat 지원 케이스 ID를 지정합니다.

string

spec.uploadTarget.sftp.caseManagementAccountSecretRef

Red Hat 고객 포털 지원 케이스에 파일을 인증하고 업로드하는 데 필요한 인증 정보를 정의합니다. 값에는 username 및 password 필드가 포함되어야 합니다.

개체

spec.uploadTarget.sftp.caseManagementAccountSecretRef.name

인증 정보가 포함된 Kubernetes 시크릿의 이름을 지정합니다.

string

spec.uploadTarget.sftp.internalUser

선택 사항: caseManagementAccountSecretRef 에 제공된 사용자가 Red Hat 내부 사용자인지 여부를 지정합니다. 유효한 값은 true 및 false 입니다. 기본값은 false입니다.

boolean

spec.uploadTarget.type

must-gather 번들의 업로드 위치 유형을 지정합니다. 지원되는 유일한 값은 SFTP 입니다.

string

참고

spec.uploadTarget 또는 spec.storage 를 지정하지 않으면 Pod가 임시 볼륨에 데이터를 저장하고 Pod가 종료되면 데이터가 영구적으로 삭제됩니다.

5.2.5. 설치 제거 지원 로그 수집
링크 복사

웹 콘솔을 사용하여 지원 로그 수집을 제거할 수 있습니다.

사전 요구 사항

  • cluster-admin 권한이 있는 클러스터에 액세스할 수 있습니다.
  • OpenShift Container Platform 웹 콘솔에 액세스할 수 있습니다.
  • 지원 로그 수집이 설치되어 있어야 합니다.

프로세스

  1. OpenShift Container Platform 웹 콘솔에 로그인합니다.

  2. 지원 로그 수집 Operator를 설치 제거합니다.

    1. Ecosystem 설치된 Operators 로 이동합니다.
    2. 지원 로그 수집 항목 옆에 있는 옵션 메뉴 kebab 를 클릭하고 Operator 설치 제거를 클릭합니다.
    3. 확인 대화 상자에서 설치 제거를 클릭합니다.

5.2.6. 지원 로그 수집 리소스 제거
링크 복사

지원 로그 수집을 제거한 후 클러스터에서 관련 리소스를 제거할 수 있습니다.

사전 요구 사항

  • cluster-admin 권한이 있는 클러스터에 액세스할 수 있습니다.
  • OpenShift Container Platform 웹 콘솔에 액세스할 수 있습니다.

프로세스

  1. OpenShift Container Platform 웹 콘솔에 로그인합니다.

  2. must-gather-operator 네임스페이스에서 구성 요소 배포를 삭제합니다.

    1. 프로젝트 드롭다운 메뉴를 클릭하여 사용 가능한 모든 프로젝트 목록을 보고 must-gather-operator 프로젝트를 선택합니다.
    2. 워크로드 배포로 이동합니다.
    3. 삭제할 배포를 선택합니다.
    4. 작업 드롭다운 메뉴를 클릭하고 배포 삭제 를 선택합니다.
    5. 확인 대화 상자에서 삭제를 클릭하여 배포를 삭제합니다.

    6. 또는 CLI(명령줄 인터페이스)를 사용하여 must-gather-operator 네임스페이스에 있는 구성 요소의 배포를 삭제합니다. 

      $ oc delete deployment -n must-gather-operator -l operators.coreos.com/support-log-gather-operator.must-gather-operator
      Copy to Clipboard Toggle word wrap

  3. 선택 사항: 지원 로그 수집에 의해 설치된 CRD(사용자 정의 리소스 정의)를 제거합니다.

    1. 관리 클러스터 리소스 정의로 이동합니다.
    2. Name 필드에 MustGather 를 입력하여 CRD를 필터링합니다.

    3. 다음 각 CRD 옆에 있는 옵션 메뉴 kebab 를 클릭하고 사용자 정의 리소스 정의 삭제를 선택합니다.

      • MustGather

  4. 선택사항: must-gather-operator 네임스페이스를 제거합니다.

    1. 관리 네임스페이스로 이동합니다.
    2. must-gather-operator 옆에 있는 옵션 메뉴 kebab 를 클릭하고 네임스페이스 삭제 를 선택합니다.
    3. 확인 대화 상자에서 must-gather-operator 를 입력하고 삭제 를 클릭합니다.
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat