MicroStrategy ONE

Platform Analytics 상태 확인 유틸리티

Platform Analytics 상태 확인 유틸리티는 엔드 투 엔드 상태 확인입니다. 이 유틸리티는 플랫폼에서 텔레메트리를 생성, 소비 및 보고하는 데 필요한 여러 구성 요소의 문제를 해결합니다. 특히, 프로젝트 중 하나의 리포트가 Platform Analytics 웨어하우스에 텔레메트리를 제공하지 않는 경우 이 확인이 권장됩니다.

Platform Analytics 상태 확인 유틸리티는 다음에서 발생하는 3개의 상태 확인을 모두 수행합니다. 시작 상태 점검및 엔드 투 엔드 텔레메트리 검사를 통해 데이터를 Intelligence Server에서 생성하고 Platform Analytics 소비자(텔레메트리 저장소)가 사용할 수 있는지 확인합니다.

Linux를 사용하는 경우 플랫폼 분석 상태 확인 유틸리티의 위치는 다음과 같습니다. /opt/MicroStrategy/PlatformAnalytics/bin. Windows를 사용하는 경우 이 위치는 C:\Program Files (x86)\MicroStrategy\Platform Analytics\bin.

Platform Analytics 상태 확인 유틸리티를 실행하는 방법

엔드 투 엔드 Platform Analytics 상태 확인을 수행하려면 platform-analytics-health-check.(sh/bat) 유틸리티.

Platform Analytics 상태 확인 유틸리티가 수행하는 엔드 투 엔드 텔레메트리 확인은 다음과 같습니다.

  1. 상태 확인
  2. Redis 상태 점검
  3. Kafka 상태 점검
  4. 변경 저널 상태 확인
  5. 통계 상태 확인

상태 확인

상태 확인 동안 두 개의 확인이 실행됩니다.

  • 소비자/프로듀서가 설치 시 제공되고 설치 시 제공되는 데이터베이스에 연결할 수 있습니까? PAConsumerConfig.yaml 구성 파일입니까? 그렇지 않은 경우 추가 네트워크 연결 테스트를 수행하여 문제의 원인을 진단합니다.
  • 데이터베이스 사용자에게 필요한 권한이 있는가? 설치 사전 요구 사항 전체 목록은 Platform Analytics 사전 요구 사항을 참조하십시오.

상태 확인 리포트는 권한 목록과 결과 상태를 제공합니다. 모든 검사가 성공하면 최종 줄은 다음과 같습니다. Warehouse health check result is healthy.

선이 다음과 같은 경우 Failed, 확인하십시오. PAConsumerConfig.yaml 파일을 삭제하고 데이터베이스에 올바른 권한이 있는지 확인하십시오.

상태 확인에서 다음 오류가 발생하는 경우 다음과 같은 해결 방법을 제안하십시오.

Missing Privileges Error(권한 누락 오류)

데이터베이스 사용자가 PAConsumerConfig.yaml 구성 파일에 권한이 누락된 경우 INFO [privilege type] privilege: Failed. 이 오류를 해결하려면 관리자가 데이터베이스 사용자에게 누락된 권한을 부여하고, 해당 소비자를 다시 시작해야 합니다.

누락된 권한을 부여하는 방법:

  1. Platform Analytics Consumer와 Usher Metadata Producer를 중지합니다.
  2. Platform Analytics 저장소가 포함된 데이터베이스 서버에 연결합니다. 'Someuser'와 'somehost'를 고객 지정 정보로 대체하는 다음 명령을 실행합니다.
    복사
    GRANT DROP ON platform_analytics_wh.* TO ‘someuser’@‘somehost’;
  3. 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 비활성화 방법:

  1. Platform Analytics 저장소에 연결하여 다음 명령을 실행합니다.
    복사
    show variables like '%ssl%';

  2. 에 대한 결과 'have_ssl' 현재 'YES' SSL이 활성화됩니다. 다음으로 사용자 만들기 mysql_native_password 및 REQUIRE NONE SSL 없이 연결하는 옵션입니다.

    복사 
    CREATE USER 'test'@'%' IDENTIFIED WITH mysql_native_password BY 'password' REQUIRE NONE;

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 서버에서 RDP 스냅샷 프로세스를 비활성화할 수 있습니다.

  1. 중지 platform-analytics-usher-lookup-producer 다음 명령을 사용하여:

    복사 
    ./platform-analytics-usher-lookup-producer.sh stop

  2. 중지 platform-analytics-consumer 다음 명령을 사용하여:

    복사 
    ./platform-analytics-consumer.sh stop
  3. Redis 서버를 중지합니다.
  4. 다음 변경 사항을 Redis.conf 파일에 적용합니다.

    1. 아래의 3줄을 주석 처리합니다. ###SNAPSHOTTING### 제목.

      복사
      #save 900 1
      #save 300 10
      #save 60 10000

    2. 같은 섹션에서 다음 행을 입력합니다.

      복사
      save ""
  5. Redis 서버를 시작합니다.

  6. 시작 platform-analytics-consumer 다음 명령을 사용하여:

    복사 
    ./platform-analytics-consumer.sh start

  7. 시작 platform-analytics-usher-lookup-producer 다음 명령을 사용하여:

    복사 
    ./platform-analytics-usher-lookup-producer.sh start

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 'server.prop'| 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의 모든 노드를 시작해야 합니다.

변경 저널 상태 확인

변경 저널 확인은 플랫폼 분석 소비자가 정상인지 확인합니다. 이 확인을 위해 테스트할 프로젝트 GUID 및 리포트 GUID를 제공해야 합니다. 변경 저널 로그를 생성하는 리포트의 설명을 수정하라는 요청을 받았습니다. 테스트는 Intelligence Server Provider가 Mstr.PpatformAnalytics.ChargyJoutal.CubsReportsDashboard Kafka 주제에 대한 로그를 생성했는지 확인합니다. 그런 다음 로그가 처리되어 Platform Analytics 웨어하우스 테이블 루_개체에 작성되었는지 테스트합니다.

레코드가 적절한 Kafka 주제와 웨어하우스 모두에서 발견된 경우 최종 줄은 Change Journal health check result is healthy.

검사에 오류가 발생하면 기능 플래그 Platform Analytics를 위한 메시징 서비스가 Intelligence Server에서 켜져 있고 Telemetry Server 활성화됨 속성이 Intelligence Server에서 True로 설정되어 있는지 확인하십시오.

Intelligence Server가 Kafka에 Telemetry를 작성하도록 구성되었는지 확인

  1. Command Manager를 사용하여 Intelligence Server에 연결합니다.
  2. 기능 플래그의 상태를 보려면 명령을 실행합니다.
    복사
    LIST ALL FEATURE FLAGS;
  3. 결과에서 Platform Analytics를 위한 메시징 서비스기능 플래그는 입니다. 켜기 . 기능 플래그가 다음과 같은 경우끄기 , 다음 명령을 실행하여 켤 수 있습니다.
    복사
    ALTER FEATURE FLAG "Messaging Service for Platform Analytics" ON;

  4. 의 상태를 보려면 Telemetry Server 활성화됨속성을 사용하려면 다음 명령을 실행합니다.

    복사 
    LIST PROPERTIES FOR SERVER CONFIGURATION;

  5. 결과에서 Telemetry Server 활성화됨속성이 (으)로 설정됨참 . 속성이 으로 설정된 경우거짓 , 아래 명령을 실행합니다.

    바꾸기 <kafka server IP> Kafka 서버 IP 주소로 을(를) 사용합니다.

    복사 
    'ALTER SERVER CONFIGURATION ENABLEMESSAGINGSERVICES TRUE CONFIGUREMESSAGINGSERVICES "bootstrap.servers: <kafka server IP>:9092/batch.num.messages:5000/queue.buffering.max.ms:2000";
  6. Intelligence Server를 다시 시작합니다.

Platform Analytics 소비자가 작동 중인지 확인

Linux의 경우:

  1. Platform Analytics가 설치된 폴더로 이동합니다. 

    <설치>/PpatformAnalytics/빈
  2. 다음 명령을 실행합니다.
    복사
    ./platform-analytics-consumer.sh status
  3. 다음 명령을 사용하여 서버를 시작하거나 다시 시작합니다.
    복사
    ./platform-analytics-consumer.sh start

서버를 다시 시작해도 문제가 해결되지 않으면 아래의 로그를 확인하십시오. <Install>/PlatformAnalytics/log/platform-analytics-consumer.log 또는 MicroStrategy 기술 지원에 문의하여 폴더를 첨부하십시오. <Install>/PlatformAnalytics/log 이해할 수 있습니다.

Windows에서:

  1. Services.msc를 사용하여 Windows 서비스를 엽니다.
  2. Telemetry Store를 시작하거나 다시 시작합니다.

서버를 다시 시작해도 문제가 해결되지 않으면 아래의 로그를 확인하십시오. <Install>/PlatformAnalytics/log/platform-analytics-consumer.log 또는 MicroStrategy 기술 지원에 문의하여 폴더를 첨부하십시오. <Install>/PlatformAnalytics/log 이해할 수 있습니다.

통계 상태 확인

이 상태 확인은 Platform Analytics 소비자가 리포트 통계를 처리할 수 있는지 확인합니다. 이전 상태 확인의 리포트를 실행하라는 메시지가 표시됩니다. 이렇게 하면 Mstr.PpatformAnalytics.IsReportstats 주제에 대한 로그가 생성됩니다. 상태 확인은 Intelligence Server 공급자가 Kafka에 대한 레코드를 생성하고 Platform Analytics 웨어하우스에 있는지 확인합니다.

레코드가 적절한 Kafka 주제와 웨어하우스 모두에서 발견된 경우 최종 줄은 Statistics health check result is healthy.

검사에서 오류가 발생하면 프로젝트에 대해 통계가 활성화되어 있고 Messaging 서비스가 올바르게 구성되었는지 확인하십시오.

프로젝트에 대한 통계가 활성화되었는지 확인

  1. Command Manager를 사용하여 Intelligence Server에 연결합니다.

  2. 명령을 실행합니다.  

    <프로젝트 이름>을 프로젝트 이름으로 바꿉니다.

    복사 
    LIST ALL PROPERTIES FOR PASTATISTICS IN PROJECT "<Project Name>";

  3. 결과에서 기본 통계 속성이 으로 설정되어 있는지 확인합니다. 참 . (으)로 설정된 경우거짓 , 아래 명령을 실행합니다.

    <프로젝트 이름>을 프로젝트 이름으로 바꿉니다.

    복사 
    ALTER PASTATISTICS BASICSTATS ENABLED DETAILEDREPJOBS TRUE DETAILEDDOCJOBS TRUE JOBSQL TRUE COLUMNSTABLES TRUE IN PROJECT "<Project Name>";
  4. Intelligence Server를 다시 시작합니다.

Platform Analytics 소비자가 작동 중인지 확인

Linux의 경우:

  1. Platform Analytics가 설치된 폴더로 이동합니다. 

    <설치>/PpatformAnalytics/빈
  2. 다음 명령을 실행합니다.
    복사
    ./platform-analytics-consumer.sh status
  3. 다음 명령을 사용하여 서버를 시작하거나 다시 시작합니다.
    복사
    ./platform-analytics-consumer.sh start

서버를 다시 시작해도 문제가 해결되지 않으면 아래의 로그를 확인하십시오. <Install>/PlatformAnalytics/log/platform-analytics-consumer.log 또는 MicroStrategy 기술 지원에 문의하여 폴더를 첨부하십시오. <Install>/PlatformAnalytics/log 이해할 수 있습니다.

Windows에서:

  1. Services.msc를 사용하여 Windows 서비스를 엽니다.
  2. Telemetry Store를 시작하거나 다시 시작합니다.

서버를 다시 시작해도 문제가 해결되지 않으면 아래의 로그를 확인하십시오. <Install>/PlatformAnalytics/log/platform-analytics-consumer.log 또는 MicroStrategy 기술 지원에 문의하여 폴더를 첨부하십시오. <Install>/PlatformAnalytics/log 이해할 수 있습니다.