MicroStrategy ONE

Dienstprogramm zur Integritätsprüfung von Platform Analytics

Das Platform Analytics Health Check Utility ist ein End-to-End-Integritätscheck. Dieses Dienstprogramm behebt Probleme mehrerer Komponenten, die zum Erstellen, Verwenden und Melden von Telemetriedaten von der Plattform erforderlich sind. Diese Prüfung wird insbesondere empfohlen, wenn ein Bericht in einem Ihrer Projekte keine Telemetriedaten an das Platform Analytics Warehouse bereitstellt.

Das Platform Analytics Health Check Utility führt alle drei Integritätsprüfungen durch, die in Integritätsprüfungen starten und End-to-End-Telemetrieprüfungen, um sicherzustellen, dass Daten vom Intelligence Server erstellt und vom Platform Analytics Consumer (Telemetry Store) genutzt werden können.

Wenn Sie Linux verwenden, befindet sich das Platform Analytics Health Check Utility unter /opt/MicroStrategy/PlatformAnalytics/bin. Wenn Sie Windows verwenden, befindet es sich unter C:\Programme (x86)\MicroStrategy\Platform Analytics\bin.

So führen Sie das Platform Analytics Health Check Utility aus

Um einen End-to-End-Plattformanalyse-Health-Check durchzuführen, führen Sie den Plattformanalyse-Integritätscheck. (sh/bat) Dienstprogramm.

Zu den vom Dienstprogramm „Platform Analytics Health Check“ durchgeführten End-to-End-Telemetrieprüfungen gehören:

  1. Gesundheitskontrolle
  2. Redis-Integritätsprüfung
  3. Kafka-Integritätscheck
  4. Integritätsprüfung des Änderungsjournals
  5. Statistik-Gesundheitscheck

Gesundheitskontrolle

Während der Integritätsprüfung werden zwei Prüfungen ausgeführt:

  • Kann der Consumer/Producer eine Verbindung mit der Datenbank herstellen, die während der Installation bereitgestellt wurde und in der Konfigurationsdatei PAConsumerConfig.yaml gespeichert ist? Wenn nicht, werden zusätzliche Tests der Netzwerkkonnektivität durchgeführt, um die Ursache des Problems zu diagnostizieren.
  • Verfügt der Datenbankbenutzer über die erforderlichen Privilegien? Eine vollständige Liste der Installationsvoraussetzungen finden Sie unter Voraussetzungen für Platform Analytics.

Der Health Check-Bericht enthält eine Liste der Berechtigungen und des daraus resultierenden Status. Wenn alle Prüfungen erfolgreich sind, lautet die letzte Zeile Das Ergebnis der Lagerintegritätsprüfung ist in Ordnung.

Wenn Zeilen mit dem Wort Failed vorhanden sind, überprüfen Sie die Datei PAConsumerConfig.yaml und vergewissern Sie sich, dass die Datenbank über die richtigen Privilegien verfügt.

Wenn Sie beim Integritätscheck einen der folgenden Fehler erhalten, finden Sie hier Lösungsvorschläge:

Fehler bei fehlenden Privilegien

Wenn der im PAConsumerConfig.yaml Konfigurationsdatei fehlen Berechtigungen, dann INFO [Berechtigungstyp]-Berechtigung: Fehlgeschlagen. Um diesen Fehler zu beheben, muss der Administrator dem Datenbankbenutzer die fehlenden Privilegien gewähren und den Consumer neu starten.

So gewähren Sie fehlende Privilegien:

  1. Stoppen Sie den Platform Analytics Consumer und den Usher Metadatenproduzent.
  2. Stellen Sie eine Verbindung zum Datenbankserver her, der das Platform Analytics Repository enthält. Führen Sie den folgenden Befehl aus und ersetzen Sie dabei „someuser“ und „somehost“ durch die entsprechenden Informationen:
    Kopieren
    GRANT DROP ON platform_analytics_wh.* TO ‘someuser’@‘somehost’;
  3. Starten Sie den Platform Analytics Consumer neu und Usher Metadatenproduzent.

Verbindungsfehler

Wenn der Konsument oder Produzent keine Verbindung zur Datenbank herstellen kann, und zwar mit der Konfiguration, die in der PAConsumerConfig.yaml Konfigurationsdatei wird möglicherweise der folgende Fehler angezeigt:

Kopieren 
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

Die Datei PAConsumerConfig.yaml wird gemäß den bei der Installation bereitgestellten Datenbankinformationen gefüllt. Um diesen Fehler zu beheben, stellen Sie eine Verbindung zum Computer her, auf dem Platform Analytics gehostet wird, und vergewissern Sie sich, dass alle Felder unter der Überschrift warehouseDbConnection in der Datei PAConsumerConfig.yaml korrekt sind.

Fehler bei falschem Kennwort des Datenbankbenutzers

Der Verbraucher oder Produzent kann keine Verbindung zur Datenbank herstellen, wenn das verschlüsselte Warehouse-Passwort falsch ist. Informationen zum Generieren eines neuen verschlüsselten Kennworts und zum Aktualisieren der Bestätigung finden Sie unter Für das Platform Analytics-Repository konfigurierte Datenbankbenutzerkennwort aktualisieren.

Fehler: Datenbankbenutzer mit aktiviertem SSL erstellt

Platform Analytics unterstützt die MySQL-Versionen 5.6, 5.7 und 8.0. Für MySQL 8.0 ist eine SSL-Verbindung automatisch aktiviert. Derzeit wird SSL für die Verbindung des Datenbankbenutzers mit MySQL von Platform Analytics nicht unterstützt. Wenn Sie den Datenbankbenutzer für den Platform Analytics Consumer oder Usher Metadata Producer, geben Sie die SSL/TLS-Option mit dem ERFORDERN Klausel.

So deaktivieren Sie SSL:

  1. Stellen Sie eine Verbindung zum Platform Analytics-Repository her und führen Sie den folgenden Befehl aus:
    Kopieren
    show variables like '%ssl%';

  2. Wenn das Ergebnis für „habe_ssl“ Ist 'JA' dann ist SSL aktiviert. Erstellen Sie den Benutzer mit mysql_native_password Und KEINE ERFORDERLICH Optionen zur Verbindung ohne SSL.

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

Redis-Integritätsprüfung

Bei der Redis-Integritätsprüfung wird bestimmt, ob der Consumer oder Producer eine Verbindung zum Redis-Server herstellen kann. Die Prüfung bietet detaillierte Statistiken zu Redis, die beim Start erfasst wurden. Wenn alle Prüfungen erfolgreich sind, lautet die letzte Zeile des Berichts Redis server health check result is healthy.

Wenn bei der Prüfung ein Fehler auftritt, stellen Sie sicher, dass Redis ausgeführt wird und dass die Konfiguration in der Datei PAConsumerConfig.yaml richtig ist.

Wenn einer der folgenden Fehler bei der Redis-Integritätsprüfung auftritt, werden folgende Problemumgehungen empfohlen:

Fehler: Redis wurde angehalten

Wenn der Consumer oder Producer keine Verbindung zu Redis herstellen kann, wurde Redis möglicherweise angehalten. Um diesen Fehler zu beheben, starten Sie den MicroStrategy In-Memory-Cache, der Platform Analytics Consumer und der Usher Metadatenproduzent.

Fehler beim Verbinden mit Redis

Wenn der Consumer oder Producer keine Verbindung zu Redis herstellen kann, ist die Konfiguration in der Datei PAConsumerConfig.yaml möglicherweise falsch. Um diesen Fehler zu beheben, stellen Sie eine Verbindung zum Computer her, auf dem Platform Analytics gehostet wird, und vergewissern Sie sich, dass alle Felder unter der Überschrift redisConnection in der Datei PAConsumerConfig.yaml korrekt sind.

Möglicherweise konnte der Redis-Server den Snapshot nicht auf die Festplatte schreiben. Wenn dies der Fall ist, können Sie den RDP-Snapshot-Prozess auf dem Redis-Server deaktivieren.

  1. Stoppen Sie die Plattform-Analyse-Usher-Lookup-Produzent mit dem folgenden Befehl:

    Kopieren 
    ./platform-analytics-usher-lookup-producer.sh stop

  2. Stoppen Sie die Plattform-Analyse-Verbraucher mit dem folgenden Befehl:

    Kopieren 
    ./platform-analytics-consumer.sh stop
  3. Stoppen Sie den Redis-Server.
  4. Wenden Sie die folgenden Änderungen auf die Datei redis.conf an:

    1. Kommentieren Sie die drei Zeilen unter dem ###SCHNAPPSCHUSS### Überschrift.

      Kopieren
      #save 900 1
      #save 300 10
      #save 60 10000

    2. Geben Sie im selben Abschnitt die folgende Zeile ein:

      Kopieren
      save ""
  5. Starten Sie den Redis-Server.

  6. Starte das Plattform-Analyse-Verbraucher mit dem folgenden Befehl:

    Kopieren 
    ./platform-analytics-consumer.sh start

  7. Starte das Plattform-Analyse-Usher-Lookup-Produzent mit dem folgenden Befehl:

    Kopieren 
    ./platform-analytics-usher-lookup-producer.sh start

Fehler: Kennwortauthentifizierung für Redis aktiviert

Wenn der Consumer oder Producer keine Verbindung zu Redis herstellen kann, wurde möglicherweise die Kennwortauthentifizierung aktiviert. Standardmäßig ist Redis ohne Kennwortauthentifizierung konfiguriert, sie kann jedoch nach der Installation festgelegt werden.

Wenn die Kennwortauthentifizierung für Redis aktiviert wurde und das Kennwort in der Konfigurationsdatei PAConsumerConfig.yaml fehlt, kann der Consumer oder Producer keine Verbindung zu Redis herstellen. Um diesen Fehler zu beheben, befolgen Sie die Schritte für Aktivieren Sie die Kennwortauthentifizierung auf dem MicroStrategy Telemetrie-Cache.

Kafka-Integritätscheck

Der Kafka Health Check stellt sicher, dass der Telemetry Manager (Apache Zookeeper) und der Telemetry Server (Kafka Server) gestartet und verbunden sind. Wenn alle Prüfungen erfolgreich sind, lautet die letzte Zeile des Berichts Kafka cluster health check result is healthy.

Da der Telemetry Server vom Telemetry Manager abhängig ist, muss der Telemetry Manager zunächst gestartet werden.

Wenn Fehler bei der Prüfung auftreten, vergewissern Sie sich, dass ZooKeeper und Kafka gestartet wurden.

So überprüfen Sie, ob auf allen Knoten ZooKeeper-Server ausgeführt werden:

  • Führen Sie unter Linux den folgenden Befehl aus, um die PID auszuführen.
    Kopieren
    ps ax | grep java | grep -i QuorumPeerMain | grep -v grep | awk '{print $1}'
  • Öffnen Sie unter Windows die Windows-Dienste und prüfen Sie, ob der Dienst \"Apache ZooKeeper\" ausgeführt wird.

So überprüfen Sie, ob auf allen Knoten Kafka-Server ausgeführt werden:

  • Führen Sie unter Linux den folgenden Befehl aus, um die PID auszuführen.
    Kopieren
    ps ax | grep -i 'server.prop'| grep java | grep -v grep | awk '{print $1}'
  • Öffnen Sie unter Windows die Windows-Dienste und prüfen Sie, ob der Dienst \"Apache Kafka\" ausgeführt wird.

So starten Sie ZooKeeper und Kafka auf allen Knoten:

  • Führen Sie unter Linux die folgenden Befehle im Kafka-Verzeichnis aus:

    Kopieren 
    # 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
  • Öffnen Sie unter Windows die Windows-Dienste und starten Sie Apache ZooKeeper und Apache Kafka.

Bei einer Cluster-Umgebung mit mehreren Knoten von ZooKeeper und Kafka, müssen Sie zunächst alle Knoten von ZooKeeper starten.

Integritätsprüfung des Änderungsjournals

Die Änderungsjournalprüfung stellt sicher, dass der Platform Analytics Consumer fehlerfrei ist. Für diese Prüfung müssen Sie zum Testen eine Projekt-GUID und eine Berichts-GUID angeben. Sie werden aufgefordert, die Beschreibung des Berichts zu ändern, wodurch ein Änderungsjournalprotokoll generiert wird. Der Test überprüft, ob der Intelligence Server Producer das Protokoll zum Kafka-Thema Mstr.PlatformAnalytics.ChangeJournal.CubesReportsDashboard erstellt hat. Anschließend wird geprüft, ob das Protokoll verarbeitet und in die Warehouse-Tabelle lu_object von Platform Analytics geschrieben wird.

Wenn der Datensatz sowohl im entsprechenden Kafka-Thema als auch im Warehouse gefunden wird, lautet die letzte Zeile Das Ergebnis der Integritätsprüfung des Änderungsjournals ist fehlerfrei.

Wenn bei Ihrer Prüfung ein Fehler auftritt, stellen Sie sicher, dass das Feature-Flag „Messaging Service für Platform Analytics“ im Intelligence-Server aktiviert ist und dass die Eigenschaft „Telemetry Server aktiviert“ im Intelligence-Server auf „True“ gesetzt ist.

Überprüfen Sie, ob der Intelligence Server so konfiguriert ist, dass Telemetriedaten in Kafka geschrieben werden.

  1. Stellen Sie mithilfe des Command Managers eine Verbindung zum Intelligence-Server her.
  2. Um den Status des Feature-Flags anzuzeigen, führen Sie den folgenden Befehl aus:
    Kopieren
    LIST ALL FEATURE FLAGS;
  3. Überprüfen Sie in den Ergebnissen die Messaging-Dienst für Plattformanalysen Feature-Flag ist AN. Wenn das Feature-Flag AUS, führen Sie den folgenden Befehl aus, um es einzuschalten:
    Kopieren
    ALTER FEATURE FLAG "Messaging Service for Platform Analytics" ON;

  4. Um den Status des Telemetrieserver aktiviert -Eigenschaft, führen Sie den folgenden Befehl aus:

    Kopieren 
    LIST PROPERTIES FOR SERVER CONFIGURATION;

  5. Überprüfen Sie in den Ergebnissen die Telemetrieserver aktiviert Die Eigenschaft ist auf WAHR. Wenn die Eigenschaft auf FALSCH, führen Sie den folgenden Befehl aus:

    Ersetzen <kafka server IP> durch die IP-Adresse Ihres Kafka-Servers.

    Kopieren 
    'ALTER SERVER CONFIGURATION ENABLEMESSAGINGSERVICES TRUE CONFIGUREMESSAGINGSERVICES "bootstrap.servers: <kafka server IP>:9092/batch.num.messages:5000/queue.buffering.max.ms:2000";
  6. Starten Sie den Intelligence-Server neu.

Überprüfen Sie, ob der Platform Analytics Consumer funktioniert

Unter Linux:

  1. Navigieren Sie zu dem Ordner, in dem Platform Analytics installiert ist.

    <Installieren>/PlatformAnalytics/bin
  2. Führen Sie den folgenden Befehl aus:
    Kopieren
    ./platform-analytics-consumer.sh status
  3. Starten oder starten Sie den Server mit dem folgenden Befehl neu:
    Kopieren
    ./platform-analytics-consumer.sh start

Wenn der Neustart des Servers das Problem nicht behebt, überprüfen Sie die Protokolle unter <Install> /PlatformAnalytics/log/platform-analytics-consumer.log oder kontaktieren Sie MicroStrategy Technischer Support und hängen Sie den Ordner an <Install> /PlatformAnalytics/log zu Ihrem Fall.

Unter Windows:

  1. Öffnen Sie die Windows-Dienste mit services.msc.
  2. Starten Sie den Telemetry Store oder starten Sie ihn neu.

Wenn der Neustart des Servers das Problem nicht behebt, überprüfen Sie die Protokolle unter <Install> /PlatformAnalytics/log/platform-analytics-consumer.log oder kontaktieren Sie MicroStrategy Technischer Support und hängen Sie den Ordner an <Install> /PlatformAnalytics/log zu Ihrem Fall.

Statistik-Gesundheitscheck

Diese Integritätsprüfung stellt sicher, dass der Platform Analytics Consumer Berichtsstatistiken verarbeiten kann. Sie werden aufgefordert, den Bericht der vorherigen Integritätsprüfung auszuführen. Dadurch wird ein Protokoll zum Thema Mstr.PlatformAnalytics.IsReportStats generiert. Durch die Integritätsprüfung wird sichergestellt, dass der Intelligence Server Producer den Datensatz für Kafka erstellt hat und dass er sich im Platform Analytics Warehouse befindet.

Wenn der Datensatz sowohl im entsprechenden Kafka-Thema als auch im Warehouse gefunden wird, lautet die letzte Zeile Das Ergebnis der Statistik-Integritätsprüfung ist in Ordnung.

Wenn bei Ihrer Prüfung ein Fehler auftritt, stellen Sie sicher, dass die Statistik für das Projekt aktiviert ist und dass die Messaging-Dienste richtig konfiguriert sind.

Überprüfen Sie, ob Statistiken für das Projekt aktiviert sind

  1. Stellen Sie mithilfe des Command Managers eine Verbindung zum Intelligence-Server her.

  2. Führen Sie folgenden Befehl aus: 

    Ersetzen Sie <Projektname> durch den Namen Ihres Projekts.

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

  3. Überprüfen Sie in den Ergebnissen, ob die Eigenschaft Grundlegende Statistiken auf WAHR. Wenn es auf FALSCH, führen Sie den folgenden Befehl aus:

    Ersetzen Sie <Projektname> durch den Namen Ihres Projekts.

    Kopieren 
    ALTER PASTATISTICS BASICSTATS ENABLED DETAILEDREPJOBS TRUE DETAILEDDOCJOBS TRUE JOBSQL TRUE COLUMNSTABLES TRUE IN PROJECT "<Project Name>";
  4. Starten Sie den Intelligence-Server neu.

Überprüfen Sie, ob der Platform Analytics Consumer funktioniert

Unter Linux:

  1. Navigieren Sie zu dem Ordner, in dem Platform Analytics installiert ist.

    <Installieren>/PlatformAnalytics/bin
  2. Führen Sie den folgenden Befehl aus:
    Kopieren
    ./platform-analytics-consumer.sh status
  3. Starten oder starten Sie den Server mit dem folgenden Befehl neu:
    Kopieren
    ./platform-analytics-consumer.sh start

Wenn der Neustart des Servers das Problem nicht behebt, überprüfen Sie die Protokolle unter <Install> /PlatformAnalytics/log/platform-analytics-consumer.log oder kontaktieren Sie MicroStrategy Technischer Support und hängen Sie den Ordner an <Install> /PlatformAnalytics/log zu Ihrem Fall.

Unter Windows:

  1. Öffnen Sie die Windows-Dienste mit services.msc.
  2. Starten Sie den Telemetry Store oder starten Sie ihn neu.

Wenn der Neustart des Servers das Problem nicht behebt, überprüfen Sie die Protokolle unter <Install> /PlatformAnalytics/log/platform-analytics-consumer.log oder kontaktieren Sie MicroStrategy Technischer Support und hängen Sie den Ordner an <Install> /PlatformAnalytics/log zu Ihrem Fall.