25장. 진단 및 문제 해결 데이터 검색


report.sh 진단 툴은 OpenShift에서 AMQ Streams 배포 문제를 해결하기 위한 필수 데이터를 수집하기 위해 Red Hat에서 제공하는 스크립트입니다. 관련 로그, 구성 파일 및 기타 진단 데이터를 수집하여 문제를 식별하고 해결합니다. 스크립트를 실행할 때 추가 매개변수를 지정하여 특정 데이터를 검색할 수 있습니다.

사전 요구 사항

  • Bash 4 이상에서 스크립트를 실행합니다.
  • OpenShift oc 명령줄 툴이 설치되어 실행 중인 클러스터에 연결하도록 구성되어 있습니다.

이렇게 하면 oc 명령줄 툴에서 클러스터와 상호 작용하고 필요한 진단 데이터를 검색하는 데 필요한 인증이 설정됩니다.

프로세스

  1. 툴을 다운로드하여 추출합니다.

    진단 툴은 AMQ Streams 소프트웨어 다운로드 페이지에서 사용할 수 있습니다.

  2. 툴을 추출한 디렉터리에서 터미널을 열고 보고 툴을 실행합니다.

    ./report.sh --namespace=<cluster_namespace> --cluster=<cluster_name> --out-dir=<local_output_directory>
    Copy to Clipboard Toggle word wrap

    < cluster_namespace >를 AMQ Streams 배포의 실제 OpenShift 네임스페이스로, < cluster_name >을 Kafka 클러스터의 이름으로, < local_output_directory >를 생성된 보고서를 저장하려는 로컬 디렉터리의 경로로 바꿉니다. 디렉터리를 지정하지 않으면 임시 디렉터리가 생성됩니다.

    필요에 따라 기타 선택적 보고 옵션을 포함합니다.

    --bridge=<string>
    Pod 및 로그에서 데이터를 가져오려면 Kafka Bridge 클러스터의 이름을 지정합니다.
    --connect=<string>
    Pod 및 로그에서 데이터를 가져올 Kafka Connect 클러스터의 이름을 지정합니다.
    --mm2=<string>
    Pod 및 로그의 데이터를 가져올 미러 메이커 2 클러스터의 이름을 지정합니다.
    --secrets=(off|hidden|all)

    시크릿 상세 정보 표시 수준을 지정합니다. 기본값은 hidden 입니다. 사용 가능한 옵션은 다음과 같습니다.

    • all: 시크릿 키와 데이터 값이 보고됩니다.
    • hidden: 키만 있는 시크릿이 보고됩니다. 암호와 같은 데이터 값이 제거됩니다.
    • Off: 시크릿은 전혀 보고되지 않습니다.

    데이터 수집 옵션이 있는 요청 예

    ./report.sh --namespace=my-amq-streams-namespace --cluster=my-kafka-cluster --bridge=my-bridge-component --secrets=all --out-dir=~/reports
    Copy to Clipboard Toggle word wrap

    참고

    필요한 경우 chmod 명령을 사용하여 스크립트에 대한 실행 권한을 사용자에게 할당합니다. 예를 들어 chmod +x report.sh.

스크립트 실행이 완료되면 출력 디렉터리에 AMQ Streams 배포의 각 구성 요소에 대해 수집된 로그, 구성 및 기타 진단 데이터의 파일 및 디렉터리가 포함됩니다.

보고 진단 툴로 수집한 데이터

다음 구성 요소의 데이터가 있는 경우 반환됩니다.

Cluster Operator

  • 배포 YAML 및 로그
  • 모든 관련 Pod 및 해당 로그
  • 클러스터 Operator와 관련된 리소스에 대한 YAML 파일(ClusterRoles, ClusterRoleBindings)

drain cleaner (있는 경우)

  • 배포 YAML 및 로그
  • Pod 로그

사용자 정의 리소스

  • CRD(사용자 정의 리소스 정의) YAML
  • 모든 관련 사용자 정의 리소스(CR)에 대한 YAML 파일

이벤트

  • 지정된 네임스페이스와 관련된 이벤트

구성

  • Kafka Pod 로그 및 구성 파일 (strimzi.properties)
  • Zookeeper Pod 로그 및 구성 파일 ( Zookeeper.properties)
  • Entity Operator(Topic Operator, User Operator) Pod 로그
  • cruise Control Pod 로그
  • Kafka Exporter Pod 로그
  • 옵션에 지정된 경우 브리지 Pod 로그
  • 옵션에 지정된 경우 Pod 로그 연결
  • 옵션에 지정된 경우 MirrorMaker 2 Pod 로그

보안 (옵션에서 요청된 경우)

  • 지정된 Kafka 클러스터와 관련된 모든 보안에 대한 YAML 파일
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat