MicroStrategy ONE
시작 상태 점검
MicroStrategy 2019 릴리스에서는 여러 서비스의 이름이 바뀌었습니다. 이 안내서에서는 기본 파일을 수정해야 하기 때문에 원래 서비스 이름을 사용합니다.
Telemetry Store(예: Platform Analytics Consumer) 및 Identity Telemetry 생산자(예: Usher Metadata Producer)는 원격 측정 로그를 처리하기 위해 다음과 같은 세 개의 구성 요소에 의존하고 이에 액세스해야 합니다.
- Platform Analytics 저장소(즉, 데이터베이스 서버)
- Telemetry Cache(예: Redis)
- Telemetry Server(예: Kafka)
이 세 구성 요소는 모두 원격 측정 로그를 성공적으로 처리할 수 있도록 Platform Analytics에 대해 양호한 상태여야 합니다. 이 중 하나라도 사용할 수 없으면 Telemetry Store 소비자와 Identity Telemetry 생산자는 중지됩니다. 따라서 시작 중에는 소비자와 생산자 모두 세 구성 요소에 상태 점검을 실행하고 그 결과에 관한 자세한 리포트를 생성합니다.
가끔 상태 점검이 시작되었을 때 구성 요소 중 하나가 아직 시작 프로세스 중이고, 완전히 준비된 상태가 아닐 수 있습니다. 그런 경우, 소비자와 생산자는 각 점검 간 간격을 60초씩 지연시켜 3회 연속 점검을 수행하여 종속성이 양호하지 않은 상태인지 여부를 확인합니다.
Platform Analytics 아키텍처에 관한 자세한 내용은 Platform Analytics 아키텍처 및 서비스를 참조하십시오.
명명 규칙 및 위치
상태 점검은 Platform Analytics Consumer와 Usher Metadata Producer의 시작 중에 수행됩니다. 따라서 기본 설치 경로에 있는 Platform Analytics log 폴더에 두 개의 상태 점검 리포트가 생성됩니다.
- Linux: /opt/MicroStrategy/PlatformAnalytics/log
- Windows: C:\Program Files (x86)\MicroStrategy\Platform Analytics\log
파일 이름을 보면 해당 리포트가 소비자에 해당하는지, 생산자에 해당하는지 알 수 있습니다.
예:
platform-analytics-consumer-health-check-yyyymmddhhmmss.out
platform-analytics-usher-lookup-producer-health-check-yyyymmddhhmmss.out
상태 점검 리포트 결과
각 상태 점검 리포트는 다음과 같은 네 개의 섹션으로 구성됩니다.
각 섹션에서는 세 가지 구성 요소의 상태에 관한 다양한 정보를 제공합니다.
상태 확인
상태 확인 동안 두 개의 확인이 실행됩니다.
- 소비자/프로듀서가 설치 시 제공되고 설치 시 제공되는 데이터베이스에 연결할 수 있습니까? PAConsumerConfig.yaml 구성 파일입니까? 그렇지 않은 경우 추가 네트워크 연결 테스트를 수행하여 문제의 원인을 진단합니다.
- 데이터베이스 사용자에게 필요한 권한이 있는가? 설치 사전 요구 사항 전체 목록은 Platform Analytics 사전 요구 사항을 참조하십시오.
상태 확인 리포트는 권한 목록과 결과 상태를 제공합니다. 모든 검사가 성공하면 최종 줄은 다음과 같습니다. Warehouse health check result is healthy.
선이 다음과 같은 경우 Failed, 확인하십시오. PAConsumerConfig.yaml 파일을 삭제하고 데이터베이스에 올바른 권한이 있는지 확인하십시오.
상태 확인에서 다음 오류가 발생하는 경우 다음과 같은 해결 방법을 제안하십시오.
Missing Privileges Error(권한 누락 오류)
데이터베이스 사용자가 PAConsumerConfig.yaml 구성 파일에 권한이 누락된 경우 INFO [privilege type] privilege: Failed. 이 오류를 해결하려면 관리자가 데이터베이스 사용자에게 누락된 권한을 부여하고, 해당 소비자를 다시 시작해야 합니다.
누락된 권한을 부여하는 방법:
- Platform Analytics Consumer와 Usher Metadata Producer를 중지합니다.
- Platform Analytics 저장소가 포함된 데이터베이스 서버에 연결합니다. 'Someuser'와 'somehost'를 고객 지정 정보로 대체하는 다음 명령을 실행합니다.복사
GRANT DROP ON platform_analytics_wh.* TO ‘someuser’@‘somehost’; - Platform Analytics Consumer와 Usher Metadata Producer를 다시 시작합니다.
연결 실패 오류
소비자 또는 공급자가 문서에 지정된 구성을 사용하여 데이터베이스에 연결할 수 없는 경우 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를 호스팅하는 시스템에 연결하고 아래의 모든 필드를 확인하십시오. warehouseDbConnection 의 제목이 올바르지 않음 PAConsumerConfig.yaml 개 파일.
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을 지원하지 않습니다. 플랫폼 분석 소비자 또는 Usher 메타데이터 공급자에 대한 데이터베이스 사용자를 생성할 때 REQUIRE 절.
SSL 비활성화 방법:
Redis 상태 점검
Redis 상태 점검은 소비자나 생산자가 Redis 서버에 성공적으로 연결할 수 있는지를 확인합니다. 이 점검에서는 시작 중에 수집된 Redis 관련 상세한 통계를 제공합니다. 모든 검사가 성공하면 최종 줄은 다음과 같습니다. Redis server health check result is healthy.
검사에서 오류가 발생하면 Redis가 실행 중이고 에서 구성이 올바른지 확인하십시오. PAConsumerConfig.yaml 개 파일.
Redis에서 다음 오류 중 하나가 발생하는 경우 상태 확인입니다. 다음과 같은 해결 방법을 제안합니다.
Redis is Stopped Error(Redis가 중지됨 오류)
소비자나 생산자가 Redis에 연결할 수 없는 경우 중지됨 상태이기 때문일 수 있습니다. 이 오류를 해결하려면 MicroStrategy In-Memory Cache, Platform Analytics Consumer, Usher Metadata Producer를 시작합니다.
Failed to Connect to Redis Error(Redis 연결 실패 오류)
소비자 또는 공급자를 Redis에 연결할 수 없는 경우는 PAConsumerConfig.yaml 개 파일. 이 오류를 해결하려면 Platform Analytics를 호스팅하는 시스템에 연결하고 아래의 모든 필드를 확인하십시오. redisConnection 의 제목이 올바르지 않음 PAConsumerConfig.yaml 개 파일.
Redis에 대한 암호 인증이 활성화됨 오류
소비자나 생산자가 Redis에 연결할 수 없는 경우 암호 인증이 활성화되어 있기 때문일 수 있습니다. 기본적으로 Redis는 암호 인증으로 구성되지 않지만 설치 후에 설정할 수 있습니다.
암호 인증을 사용하여 Redis를 활성화한 경우 PAConsumerConfig.yaml 구성 파일을 설치하면 소비자 또는 공급자를 Redis에 연결할 수 없습니다. 이 오류를 해결하려면 MicroStrategy Telemetry Cache의 암호 인증 활성화의 단계를 따르십시오.
Kafka 상태 점검
Kafka 상태 확인은 Telemetry Manager(Apeach Zookeeper) 및 Telemetry Server(kafka Server)가 시작되고 연결되었는지 확인합니다. 모든 검사가 성공하면 최종 줄은 다음과 같습니다. Kafka cluster health check result is healthy.
Telemetry Server는 Telemetry Manager에 종속되어 있기 때문에 Telemetry Manager를 먼저 시작해야 합니다.
점검 시 오류가 발견되면 ZooKeeper와 Kafka가 시작되었는지 확인합니다.
Zookeeper 서버가 모든 노드에서 실행 중인지 확인하는 방법:
- Linux에서 다음 명령을 실행하여 ID를 실행합니다.복사
ps ax | grep java | grep -i QuorumPeerMain | grep -v grep | awk '{print $1}' - Windows에서 Windows의 서비스를 열고 \"Apeach ZooKreeper\" 서비스가 실행 중인지 확인합니다.
모든 노드에서 Kafka 서버가 실행 중인지 확인하는 방법:
- Linux에서 다음 명령을 실행하여 ID를 실행합니다.복사
ps ax | grep -i 'kafka\\.Kafka' | grep java | grep -v grep | awk '{print $1}' - Windows에서 Windows의 서비스를 열고 \"Apeach 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에서 Windows의 서비스를 열고 Apache Zookeeper 및 Apache Kafka를 시작합니다.
ZooKeeper와 Kafka의 여러 노드로 클러스터된 환경인 경우, 먼저 ZooKeeper의 모든 노드를 시작해야 합니다.
상태 점검 요약
모든 상태 확인이 성공하면 결과는 passing. 확인이 실패한 경우 FAIL 이(가) 포함된 구성 요소입니다. 실패한 경우, 위의 자세한 리포트 목록을 이용하여 실패의 가능한 원인을 조사합니다.
