25장. 진단 및 문제 해결 데이터 검색
report.sh 진단 툴은 OpenShift에서 AMQ Streams 배포 문제를 해결하기 위한 필수 데이터를 수집하기 위해 Red Hat에서 제공하는 스크립트입니다. 관련 로그, 구성 파일 및 기타 진단 데이터를 수집하여 문제를 식별하고 해결합니다. 스크립트를 실행할 때 추가 매개변수를 지정하여 특정 데이터를 검색할 수 있습니다.
사전 요구 사항
- Bash 4 이상에서 스크립트를 실행합니다.
-
OpenShift
oc명령줄 툴이 설치되어 실행 중인 클러스터에 연결하도록 구성되어 있습니다.
이렇게 하면 oc 명령줄 툴에서 클러스터와 상호 작용하고 필요한 진단 데이터를 검색하는 데 필요한 인증이 설정됩니다.
프로세스
툴을 다운로드하여 추출합니다.
진단 툴은 AMQ Streams 소프트웨어 다운로드 페이지에서 사용할 수 있습니다.
툴을 추출한 디렉터리에서 터미널을 열고 보고 툴을 실행합니다.
./report.sh --namespace=<cluster_namespace> --cluster=<cluster_name> --out-dir=<local_output_directory>
./report.sh --namespace=<cluster_namespace> --cluster=<cluster_name> --out-dir=<local_output_directory>Copy to Clipboard Copied! Toggle word wrap Toggle overflow <
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
./report.sh --namespace=my-amq-streams-namespace --cluster=my-kafka-cluster --bridge=my-bridge-component --secrets=all --out-dir=~/reportsCopy to Clipboard Copied! Toggle word wrap Toggle overflow 참고필요한 경우
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 파일