MicroStrategy ONE
시작 상태 점검
여러 서비스의 이름이 다음에서 변경되었습니다. MicroStrategy 2019년 출시. 이 안내서에서는 기본 파일을 수정해야 하기 때문에 원래 서비스 이름을 사용합니다.
Telemetry Store(예: Platform Analytics 소비자) 및 Identity Telemetry 생산자(예: Usher 메타데이터 생산자)는 원격 분석 로그를 처리하기 위해 다음 세 가지 구성 요소에 의존하며 이에 대한 액세스가 필요합니다.
- Platform Analytics 저장소(예: 데이터베이스 서버)
- Telemetry Cache(예: Redis)
- Telemetry Server(예: Kafka)
이 세 구성 요소는 모두 원격 측정 로그를 성공적으로 처리할 수 있도록 Platform Analytics에 대해 양호한 상태여야 합니다. 이 중 하나라도 사용할 수 없으면 Telemetry Store 소비자와 Identity Telemetry 생산자는 중지됩니다. 따라서 시작 중에는 소비자와 생산자 모두 세 구성 요소에 상태 점검을 실행하고 그 결과에 관한 자세한 리포트를 생성합니다.
가끔 상태 점검이 시작되었을 때 구성 요소 중 하나가 아직 시작 프로세스 중이고, 완전히 준비된 상태가 아닐 수 있습니다. 그런 경우, 소비자와 생산자는 각 점검 간 간격을 60초씩 지연시켜 3회 연속 점검을 수행하여 종속성이 양호하지 않은 상태인지 여부를 확인합니다.
Platform Analytics 아키텍처에 관한 자세한 내용은 Platform Analytics 아키텍처 및 서비스를 참조하십시오.
명명 규칙 및 위치
상태 점검은 두 장치를 모두 시작하는 동안 수행됩니다. 플랫폼 분석 소비자 그리고 Usher 메타데이터 생산자. 따라서 기본 설치 경로에 있는 Platform Analytics log 폴더에 두 개의 상태 점검 리포트가 생성됩니다.
- Linux: /고르다/MicroStrategy/플랫폼 분석/로그
- Windows: C:\프로그램 파일(x86)\MicroStrategy\플랫폼 분석\로그
파일 이름을 보면 해당 리포트가 소비자에 해당하는지, 생산자에 해당하는지 알 수 있습니다.
예:
platform-analytics-consumer-health-check-yyyymmddhhmmss.out
platform-analytics-usher-lookup-producer-health-check-yyyymmddhhmmss.out
상태 점검 리포트 결과
각 상태 점검 리포트는 다음과 같은 네 개의 섹션으로 구성됩니다.
각 섹션에서는 세 가지 구성 요소의 상태에 관한 다양한 정보를 제공합니다.
건강 체크
상태 확인 중에는 두 가지 확인이 실행됩니다.
- 소비자/생산자가 설치 중에 제공되어 PAConsumerConfig.yaml 구성 파일에 저장된 데이터베이스에 연결할 수 있는가? 그렇지 않은 경우 문제의 원인을 진단하기 위해 추가 네트워크 연결 테스트가 수행됩니다.
- 데이터베이스 사용자에게 필요한 권한이 있는가? 설치 사전 요구 사항 전체 목록은 Platform Analytics 사전 요구 사항을 참조하십시오.
상태 점검 보고서는 권한 목록과 결과 상태를 제공합니다. 모든 검사가 성공하면 마지막 줄은 다음과 같습니다. 창고 상태 점검 결과가 양호함.
Failed(실패)라고 표시된 행이 있는 경우 PAConsumerConfig.yaml 파일을 점검하여 데이터베이스에 정확한 권한이 있는지 확인합니다.
상태 확인에서 다음과 같은 오류가 발생하는 경우 해결 방법은 다음과 같습니다.
Missing Privileges Error(권한 누락 오류)
데이터베이스 사용자가 PAConsumerConfig.yaml 구성 파일에 권한이 없습니다. INFO [권한 유형] 권한: 실패한. 이 오류를 해결하려면 관리자가 데이터베이스 사용자에게 누락된 권한을 부여하고, 해당 소비자를 다시 시작해야 합니다.
누락된 권한을 부여하는 방법:
- Platform Analytics Consumer를 중지하고 Usher 메타데이터 생산자.
- Platform Analytics 저장소가 포함된 데이터베이스 서버에 연결합니다. 'someuser'와 'somehost'를 고객 지정 정보로 대체하는 다음 명령을 실행합니다.복사
GRANT DROP ON platform_analytics_wh.* TO ‘someuser’@‘somehost’;
- Platform Analytics Consumer를 다시 시작하고 Usher 메타데이터 생산자.
연결 실패 오류
소비자 또는 생산자가 다음에 지정된 구성을 사용하여 데이터베이스에 연결할 수 없는 경우 PAConsumerConfig.yaml 구성 파일을 보면 다음과 같은 오류가 나타날 수 있습니다.
2018-11-21 21:43:28,793 INFO HealthCheck main - Failed to connect to the database. Retrying after waiting for 60 seconds.
2018-11-21 21:45:31,797 INFO HealthCheck main - Failed to connect to the database. Retrying after waiting for 60 seconds.
2018-11-21 21:47:34,800 ERROR HealthCheck main - Failed to connect to the database using url:jdbc:mysql://XX.Y.Z.1:3306/platform_analytics_wh?rewriteBatchedStatements=true&useLegacyDatetimeCode=false&serverTimezone=UTC. Please double check your connection parameters.
Communications link failure
PAConsumerConfig.yaml 파일은 설치 중 제공된 데이터베이스 정보를 토대로 채워집니다. 이 오류를 해결하려면 Platform Analytics를 호스팅하는 시스템에 연결하여PAConsumerConfig.yaml 파일에서 warehouseDbConnection 머리글 아래의 모든 필드가 정확한지 확인합니다.
Database User Password is Incorrect Error(데이터베이스 사용자 암호가 올바르지 않음 오류)
암호화된 웨어하우스 비밀번호가 올바르지 않으면 소비자나 생산자는 데이터베이스에 연결할 수 없습니다. 새로운 암호화된 암호를 생성하고 확인을 업데이트하려면 Platform Analytics 저장소에 대해 구성된 데이터베이스 사용자 암호 업데이트를 참조하십시오.
Database User Created with SSL Enabled Error(SSL이 활성화된 상태에서 데이터베이스 사용자가 생성됨 오류)
Platform Analytics는 MySQL 5.6, 5.7, 8.0을 지원합니다. MySQL 8.0의 경우 SSL 연결은 기본적으로 활성화되어 있습니다. 현재 Platform Analytics에서는 MySQL 연결 데이터베이스 사용자에 대해 SSL을 지원하지 않습니다. Platform Analytics Consumer에 대한 데이터베이스 사용자를 생성하는 경우 또는 Usher 메타데이터 생산자에서는 다음을 사용하여 SSL/TLS 옵션을 지정합니다. 필요하다 절.
SSL 비활성화 방법:
Redis 상태 점검
Redis 상태 점검은 소비자나 생산자가 Redis 서버에 성공적으로 연결할 수 있는지를 확인합니다. 이 점검에서는 시작 중에 수집된 Redis 관련 상세한 통계를 제공합니다. 모든 점검을 통과하면 마지막 행 MySQL warehouse health check result is healthy(MySQL 웨어하우스 상태 점검 결과가 양호함)라고 표시됩니다.
점검에 오류가 있는 경우 Redis가 실행 중인지와 PAConsumerConfig.yaml 파일의 구성이 올바른지 확인하십시오.
Redis 상태 점검에서 다음과 같은 오류를 수신하는 경우 다음과 같은 해결 방법이 제안됩니다.
Redis is Stopped Error(Redis가 중지됨 오류)
소비자나 생산자가 Redis에 연결할 수 없는 경우 중지됨 상태이기 때문일 수 있습니다. 이 오류를 해결하려면 MicroStrategy 인메모리 캐시, 플랫폼 분석 소비자 및 Usher 메타데이터 생산자.
Failed to Connect to Redis Error(Redis 연결 실패 오류)
소비자나 생산자가 Redis에 연결할 수 없는 경우 PAConsumerConfig.yaml 파일의 구성이 올바르지 않기 때문일 수 있습니다. 이 오류를 해결하려면 Platform Analytics를 호스팅하는 시스템에 연결하여 PAConsumerConfig.yaml 파일에서 redisConnection 머리글 아래의 모든 필드가 정확한지 확인합니다.
Password Authentication Enabled for Redis Error(Redis에 대해 암호 인증이 활성화되어 있음 오류)
소비자나 생산자가 Redis에 연결할 수 없는 경우 암호 인증이 활성화되어 있기 때문일 수 있습니다. 기본적으로 Redis는 암호 인증으로 구성되지 않지만 설치 후에 설정할 수 있습니다.
Redis에 암호 인증이 활성화되어 있고 PAConsumerConfig.yaml 파일에서 암호가 누락된 경우, 소비자나 생산자가 Redis에 연결할 수 없게 됩니다. 이 오류를 해결하려면 다음 단계를 따르세요. 비밀번호 인증 활성화 MicroStrategy 원격 측정 캐시.
카프카 상태 점검
Kafka 상태 점검은 Telemetry Manager(Apache Zookeeper)와 Telemetry Server(Kafka Server)가 시작되고 연결되어 있는지 확인합니다. 모든 점검을 통과하면 마지막 행에 Kafka cluster health check result is healthy(Kafka 클러스터 상태 점검 결과가 양호함)라고 표시됩니다.
Telemetry Server는 Telemetry Manager에 종속되어 있기 때문에 Telemetry Manager를 먼저 시작해야 합니다.
점검 시 오류가 발견되면 ZooKeeper와 Kafka가 시작되었는지 확인합니다.
ZooKeeper 서버가 모든 노드에서 실행 중인지 확인하는 방법:
- Linux에서는 다음 명령을 실행하여 PID를 실행합니다.복사
ps ax | grep java | grep -i QuorumPeerMain | grep -v grep | awk '{print $1}'
- Windows에서는 Window 서비스를 열고 \"Apache ZooKeeper\" 서비스가 실행 중인지 확인하세요.
Kafka 서버가 모든 노드에서 실행 중인지 확인하는 방법:
- Linux에서는 다음 명령을 실행하여 PID를 실행합니다.복사
ps ax | grep -i 'kafka\\.Kafka' | grep java | grep -v grep | awk '{print $1}'
- Windows에서는 Window 서비스를 열고 \"Apache Kafka\" 서비스가 실행 중인지 확인하세요.
모든 노드에서 ZooKeeper 및 Kafka를 시작하는 방법:
-
Linux에서는 Kafka 디렉터리에서 다음 명령을 실행합니다.
복사# Start Zookeeper on all nodes,
./zookeeper-server-start.sh -daemon ../config/zookeeper.properties
# Start Kafka on all nodes,
./kafka-server-start.sh -daemon ../config/server.properties - Windows에서는 Window 서비스를 열고 Apache ZooKeeper 및 Apache Kafka를 시작합니다.
ZooKeeper와 Kafka의 여러 노드로 클러스터된 환경인 경우, 먼저 ZooKeeper의 모든 노드를 시작해야 합니다.
상태 점검 요약
모든 상태 점검을 통과한 경우, 결과는 passing(통과)으로 표시됩니다. 점검 중 하나라도 실패하는 경우, 해당 구성 요소에 FAIL(실패)이라고 표시됩니다. 실패한 경우, 위의 자세한 리포트 목록을 이용하여 실패의 가능한 원인을 조사합니다.