MicroStrategy ONE

플랫폼 분석 상태 점검 유틸리티

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

Platform Analytics 상태 확인 유틸리티는 다음에서 발생하는 세 가지 상태 확인을 모두 수행합니다. 시작 상태 점검 Intelligence Server에서 데이터가 생성되고 Platform Analytics Consumer(Telemetry Store)에서 소비될 수 있는지 확인하기 위한 엔드투엔드 원격 측정 검사입니다.

Linux를 사용하는 경우 Platform Analytics 상태 점검 유틸리티는 다음 위치에 있습니다. /고르다/MicroStrategy/플랫폼분석/bin. Windows를 사용하는 경우 다음 위치에 있습니다. C:\프로그램 파일(x86)\MicroStrategy\플랫폼 분석\bin.

Platform Analytics 상태 점검 유틸리티를 실행하는 방법

엔드투엔드 Platform Analytics 상태 확인을 수행하려면 다음을 실행하세요. 플랫폼 분석-상태 확인.(sh/bat) 공익사업.

Platform Analytics 상태 확인 유틸리티에서 수행되는 엔드투엔드 원격 측정 검사에는 다음이 포함됩니다.

  1. 건강 체크
  2. Redis 상태 점검
  3. 카프카 상태 점검
  4. 저널 상태 점검 변경
  5. 통계 건강검진

건강 체크

상태 확인 중에는 두 가지 확인이 실행됩니다.

  • 소비자/생산자가 설치 중에 제공되어 PAConsumerConfig.yaml 구성 파일에 저장된 데이터베이스에 연결할 수 있는가? 그렇지 않은 경우 문제의 원인을 진단하기 위해 추가 네트워크 연결 테스트가 수행됩니다.
  • 데이터베이스 사용자에게 필요한 권한이 있는가? 설치 사전 요구 사항 전체 목록은 Platform Analytics 사전 요구 사항을 참조하십시오.

상태 점검 보고서는 권한 목록과 결과 상태를 제공합니다. 모든 검사가 성공하면 마지막 줄은 다음과 같습니다. 창고 상태 점검 결과가 양호함.

Failed(실패)라고 표시된 행이 있는 경우 PAConsumerConfig.yaml 파일을 점검하여 데이터베이스에 정확한 권한이 있는지 확인합니다.

상태 확인에서 다음과 같은 오류가 발생하는 경우 해결 방법은 다음과 같습니다.

Missing Privileges Error(권한 누락 오류)

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

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

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

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

  2. 에 대한 결과라면 'have_ssl' ~이다 '예' 그러면 SSL이 활성화됩니다. 다음을 사용하여 사용자를 생성합니다. mysql_native_password 그리고 필요하지 않음 SSL 없이 연결하는 옵션.

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

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 머리글 아래의 모든 필드가 정확한지 확인합니다.

Redis 서버가 디스크에 스냅샷을 쓰지 못했을 가능성이 있습니다. 이 경우 Redis 서버에서 RDP 스냅샷 프로세스를 비활성화할 수 있습니다.

  1. 그만해 플랫폼 분석-어셔-조회-생산자 다음 명령을 사용합니다.

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

  2. 그만해 플랫폼-분석-소비자 다음 명령을 사용합니다.

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

    1. 아래 세 줄을 주석 처리하세요. ###스냅샷### 표제.

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

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

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

  6. 시작하다 플랫폼-분석-소비자 다음 명령을 사용합니다.

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

  7. 시작하다 플랫폼 분석-안내-조회-생산자 다음 명령을 사용합니다.

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

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

저널 상태 점검 변경

Change Journal 확인을 통해 Platform Analytics Consumer가 정상인지 확인합니다. 이 확인을 위해서는 테스트할 프로젝트 GUID와 보고서 GUID를 제공해야 합니다. 변경 저널 로그를 생성하는 보고서의 설명을 수정하라는 메시지가 표시됩니다. 테스트에서는 Intelligence Server Producer가 Mstr.PlatformAnalytics.ChangeJournal.CubesReportsDashboard Kafka 주제에 대한 로그를 생성했는지 확인합니다. 그런 다음 로그가 처리되어 Platform Analytics 웨어하우스 테이블 lu_object에 기록되는지 테스트합니다.

적절한 Kafka 주제와 웨어하우스 모두에서 레코드가 발견되면 마지막 줄은 다음과 같습니다. Change Journal 상태 점검 결과가 정상입니다..

검사에서 오류가 발견되면 Intelligence Server에서 Platform Analytics용 Messaging Service 기능 플래그가 켜져 있고 Intelligence Server에서 Telemetry Server 활성화 속성이 True로 설정되어 있는지 확인하세요.

Intelligence Server가 Kafka에 원격 분석을 기록하도록 구성되어 있는지 확인

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

  4. 상태를 보려면 텔레메트리 서버 활성화 속성에서 다음 명령을 실행합니다.

    복사 
    LIST PROPERTIES FOR SERVER CONFIGURATION;

  5. 결과에서 다음을 확인하십시오. 텔레메트리 서버 활성화 속성은 다음과 같이 설정됩니다. 진실. 속성이 다음으로 설정된 경우 거짓, 아래 명령을 실행하십시오.

    바꾸다 <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 서버를 다시 시작합니다.

Platform Analytics 소비자가 작동하는지 확인

리눅스의 경우:

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

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

서버를 다시 시작해도 문제가 해결되지 않으면 아래의 로그를 확인하세요. <Install> /PlatformAnalytics/log/platform-analytics-consumer.log 또는 연락 MicroStrategy 기술 지원 및 폴더 첨부 <Install> /플랫폼 분석/로그 당신의 경우에.

Windows의 경우:

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

서버를 다시 시작해도 문제가 해결되지 않으면 아래의 로그를 확인하세요. <Install> /PlatformAnalytics/log/platform-analytics-consumer.log 또는 연락 MicroStrategy 기술 지원 및 폴더 첨부 <Install> /플랫폼 분석/로그 당신의 경우에.

통계 건강검진

이 상태 확인을 통해 Platform Analytics Consumer가 보고서 통계를 처리할 수 있습니다. 이전 상태 확인에서 보고서를 실행하라는 메시지가 표시됩니다. 그러면 Mstr.PlatformAnalytics.IsReportStats 항목에 대한 로그가 생성됩니다. 상태 확인은 Intelligence Server Producer가 Kafka에 레코드를 생성했고 해당 레코드가 Platform Analytics 웨어하우스에 있는지 확인합니다.

적절한 Kafka 주제와 웨어하우스 모두에서 레코드가 발견되면 마지막 줄은 다음과 같습니다. 통계 헬스체크 결과가 정상입니다.

검사에서 오류가 발견되면 프로젝트에 대한 통계가 활성화되어 있고 메시징 서비스가 올바르게 구성되어 있는지 확인하세요.

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

  1. Command Manger를 사용하여 Intelligence 서버에 연결합니다.

  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 서버를 다시 시작합니다.

Platform Analytics 소비자가 작동하는지 확인

리눅스의 경우:

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

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

서버를 다시 시작해도 문제가 해결되지 않으면 아래의 로그를 확인하세요. <Install> /PlatformAnalytics/log/platform-analytics-consumer.log 또는 연락 MicroStrategy 기술 지원 및 폴더 첨부 <Install> /플랫폼 분석/로그 당신의 경우에.

Windows의 경우:

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

서버를 다시 시작해도 문제가 해결되지 않으면 아래의 로그를 확인하세요. <Install> /PlatformAnalytics/log/platform-analytics-consumer.log 또는 연락 MicroStrategy 기술 지원 및 폴더 첨부 <Install> /플랫폼 분석/로그 당신의 경우에.