Strategy ONE

MicroStrategy Telemetry Server

MicroStrategy Telemetry Server unter Windows

Telemetry Server ist eine Komponente, die bei Installationen und Upgrades mit dem Intelligence Server gekoppelt wird. Telemetry Server ist sofort konfiguriert und wird nach Abschluss der Installation automatisch ausgeführt.

Nach der Installation werden die folgenden Dienste automatisch gestartet:

  • Apache Kafka (C:\Program Files (x86)\MicroStrategy\Telemetry Server\Kafka\kafka_2.13-2.6.1 )
  • Apache ZooKeeper (C:\Program Files (x86)\MicroStrategy\Telemetry Server\Kafka\kafka_2.13-2.6.1 )

Standardmäßig wird MicroStrategy weiterhin Intelligence Server-Diagnoseprotokolle an die lokalen Festplatte senden. Diagnoseprotokolle werden an den Telemetry Server Server gesendet, nachdem Sie die folgenden Schritte ausgeführt haben:

Anschließend werden Kafka-Protokolldateien im Kafka-Installationsordner erstellt:

C:\Program Files (x86)\MicroStrategy\Telemetry Server\tmp\kafka-logs

Es werden mehrere Kafka-Themen erstellt, um Daten für verschiedene MicroStrategy-Komponenten zu speichern.

Telemetry Server wird nach dem Upgrade konfiguriert

Standardmäßig wird MicroStrategy Telemetry Server zusammen mit dem Intelligence-Server-Upgrade installiert.

Telemetry Server-Workflow für Intelligence Server

  • Intelligence Server fungiert als Kafka-Produzent und kann als einzelner Knoten oder Cluster bereitgestellt werden.
  • Der Kafka-Server kann als einzelner Knoten oder Cluster bereitgestellt werden.

Aktivieren Sie MicroStrategy Telemetry Server

Die Telemetry Server-Konfiguration wird in der MicroStrategy Intelligence Server-Konfiguration gespeichert. Diese Funktion kann umgehend aktiviert oder deaktiviert werden, ohne Intelligence Server neu zu starten.

Command Manager-Skripts für Telemetry Server

Führen Sie den folgenden Befehl aus, um zu überprüfen, ob Telemetry Server aktiviert ist:

LIST ALL PROPERTIES FOR SERVER CONFIGURATION;

Führen Sie Folgendes aus, um Telemetry Server über den Command Manager zu aktivieren:

ALTER SERVER CONFIGURATION ENABLEMESSAGINGSERVICES TRUE CONFIGUREMESSAGINGSERVICES "bootstrap.servers:10.15.208.236:9092/batch.num.messages:5000/queue.buffering.max.ms:2000";

Legen Sie die Parameter im obigen Beispiel wie folgt fest:

  • bootstrap.servers: für Ihre Kafka-Server-IP-Adresse und Portnummer.
  • batch.num.messages: zur Anzahl der Nachrichten, die in einem Stapel bei Verwendung des asynchronen Modus gesendet werden sollen.
  • queue.buffering.max.ms: auf die maximale Zeit zum Puffern von Daten bei Verwendung des asynchronen Modus.

Mit dem gleichen Format können Sie in diesem Befehl weitere Kafka-Producer-Konfigurationseinstellungen angeben.

Aktivieren Sie die Funktion zum Senden von Protokoll an Telemetry Server

Sie können die Funktion „Protokoll an Telemetry Server senden“ entweder über MicroStrategy Web oder Command Manager aktivieren.

In MicroStrategy Web

  1. Melden Sie sich mit einem Administratorkonto an.
  2. Benutzer öffnen Einstellungen > Projektstandards.
  3. Suchen Protokoll wird an Telemetry Server gesendet im Abschnitt „Funktionen für Kundenfeedback“.
  4. Auswählen Ein aus dem Dropdown-Menü aus.
  5. Klicken Sie auf Übernehmen.

In Command Manager

  1. Stellen Sie eine Verbindung mit Ihrer Projektquelle her.
  2. Führen Sie das folgende Skript aus:

    ALTER FEATURE FLAG "SENDING LOG TO TELEMETRY SERVER" ON;

Telemetry Server-Konfiguration wird geändert

Apache Kafka-Server

Der Kafka-Server kann durch Ändern von konfiguriert werden server.properties Datei gefunden in:

C:\Program Files (x86)\MicroStrategy\Telemetry Server\Kafka\kafka_2.13-2.6.1\config

Sowohl Apache Kafka-Server als auch ZooKeeper sollten nach einer Änderung der oben angegebenen Konfigurationsdatei neu gestartet werden.

MicroStrategy Telemetry Server-Konfiguration für Cluster-Umgebungen

Wenn Sie Ihre Intelligence Server geclustert haben und nach dem Upgrade einen separaten Computer zum Ausführen von MicroStrategy Telemetry Server verwenden möchten, führen Sie die folgenden Schritte für jeden Knoten im Cluster durch.

Die Mindestanzahl an Knoten für ein Cluster beträgt 3.

Auf jedem Knoten muss Folgendes installiert sein:

  • MicroStrategy Telemetry Server
  • Apache Kafka
  • Apache Zookeeper

Zookeeper konfigurieren

  1. Zum Ordner navigieren C:\Program Files (x86)\MicroStrategy\Telemetry Server\Kafka\kafka_2.13-2.6.1\config.
  2. Datei bearbeiten zookeeper.properties durch Hinzufügen der folgenden Zeilen:

    Kopieren
    clientPort=2181
    dataDir=C:\\Program Files (x86)\\MicroStrategy\\Telemetry Server\\tmp\\zookeeper
    maxClientCnxns=0
    initLimit=5
    syncLimit=2
    server.1=10.27.20.16:2888:3888
    server.2=10.27.20.60:2888:3888
    server.3=10.15.208.236:2888:3888

    Jeder Serverparameter muss eine eindeutige ganzzahlige ID enthalten, wie oben dargestellt. Sie können jedem Computer die Server-ID zuordnen, indem Sie eine Textdatei mit dem Namen erstellen myid, eine für jeden Server, die sich im Datenverzeichnis dieses Servers befindet, wie durch den Konfigurationsdateiparameter angegeben dataDir = C:\Program Files (x86)\MicroStrategy\Telemetry Server\tmp\zookeeper

  3. Zum Ordner wechseln C:\Program Files (x86)\MicroStrategy\TelemetryServer\Kafka\kafka_2.13-2.6.1\config.

  4. Erstellen Sie eine Textdatei mit dem Namen myid der den identifizierenden Wert aus dem Serverparameternamen in enthält zookeeper.properties Datei.

Kafka konfigurieren

  1. Zum Ordner navigieren C:\Program Files (x86)\MicroStrategy\Telemetry Server\Kafka\kafka_2.13-2.6.1\config.
  2. Datei bearbeiten server.properties, eine Zeile hinzufügen zookeeper.connect=10.27.20.16:2181,10.27.20.60:2181,10.15.208.236:2181 zum Zookeeper-Abschnitt.

    Kopieren
    ############################# Zookeeper #############################
    # Zookeeper connection string (see zookeeper docs for details).
    # This is a comma separated host:port pairs, each corresponding to a zk# server. e.g. "127.0.0.1:3000,127.0.0.1:3001,127.0.0.1:3002".
    # You can also append an optional chroot string to the urls to specify the# root directory for all kafka znodes.
    # zookeeper.connect=localhost:2181
    zookeeper.connect=10.27.20.16:2181,10.27.20.60:2181,10.15.208.236:2181
  3. Ändern Sie die broker.id Wert zu einer eindeutigen Ganzzahl von anderen Kafka-Servern (der Standardwert ist 0), z. B. für Knoten 10.27.20.60 verwenden wir Nummer 2.

    Kopieren
    ############################# Server Basics #############################
    # The id of the broker. This must be set to a unique integer for each broker.
    broker.id=2

Starten, anhalten, neu starten und Status von Telemetry Server prüfen

Öffnen Sie bei Windows-Installationen Task-Manager > Services zum Starten, Anhalten, Neustarten und Prüfen des Status von Telemetry Server-Komponenten.

MicroStrategy Telemetry Server unter Linux

Telemetry Server ist eine Komponente, die bei Installationen und Upgrades mit dem Intelligence Server gekoppelt wird. Telemetry Server ist sofort konfiguriert und wird nach Abschluss der Installation automatisch ausgeführt.

Nach der Installation werden die folgenden Dienste automatisch gestartet:

  • Apache Kafka (/opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0)
  • Apache ZooKeeper (/opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0)

Standardmäßig wird MicroStrategy weiterhin Intelligence Server-Diagnoseprotokolle an die lokalen Festplatte senden. Diagnoseprotokolle werden an den Telemetry Server gesendet, nachdem Sie die folgenden Schritte ausgeführt haben:

Anschließend werden Kafka-Protokolldateien im Kafka-Installationsordner erstellt:

/opt/MicroStrategy/TelemetryServer/Kafka/tmp/kafka-logs

Es werden mehrere Kafka-Themen erstellt, um Daten für verschiedene MicroStrategy-Komponenten zu speichern.

Telemetry Server wird nach dem Upgrade konfiguriert

Standardmäßig wird MicroStrategy Telemetry Server zusammen mit dem Intelligence-Server-Upgrade installiert.

Telemetry Server-Workflow für Intelligence Server

  • Intelligence Server fungiert als Kafka-Produzent und kann als einzelner Knoten oder Cluster bereitgestellt werden.
  • Der Kafka-Server kann als einzelner Knoten oder Cluster bereitgestellt werden.

Aktivieren Sie MicroStrategy Telemetry Server

Die Telemetry Server-Konfiguration wird in der MicroStrategy Intelligence Server-Konfiguration gespeichert. Diese Funktion kann umgehend aktiviert oder deaktiviert werden, ohne Intelligence Server neu zu starten.

Command Manager-Skripts für Telemetry Server

Führen Sie den folgenden Befehl aus, um zu überprüfen, ob Telemetry Server aktiviert ist:

LIST ALL PROPERTIES FOR SERVER CONFIGURATION;

Führen Sie Folgendes aus, um Telemetry Server über den Command Manager zu aktivieren:

ALTER SERVER CONFIGURATION ENABLEMESSAGINGSERVICES TRUE CONFIGUREMESSAGINGSERVICES "bootstrap.servers:10.15.208.236:9092/batch.num.messages:5000/queue.buffering.max.ms:2000";

Legen Sie die Parameter im obigen Beispiel wie folgt fest:

  • bootstrap.servers: für Ihre Kafka-Server-IP-Adresse und Portnummer.
  • batch.num.messages: zur Anzahl der Nachrichten, die in einem Stapel bei Verwendung des asynchronen Modus gesendet werden sollen.
  • queue.buffering.max.ms: auf die maximale Zeit zum Puffern von Daten bei Verwendung des asynchronen Modus.

Mit dem gleichen Format können Sie in diesem Befehl weitere Kafka-Producer-Konfigurationseinstellungen angeben.

Aktivieren Sie die Funktion zum Senden von Protokoll an Telemetry Server

Sie können die Funktion „Protokoll an Telemetry Server senden“ entweder über MicroStrategy Web oder Command Manager aktivieren.

In MicroStrategy Web

  1. Melden Sie sich mit einem Administratorkonto an.
  2. Benutzer öffnen Einstellungen > Projektstandards.
  3. Suchen Protokoll wird an Telemetry Server gesendet im Abschnitt „Funktionen für Kundenfeedback“.
  4. Auswählen Ein aus dem Dropdown-Menü aus.
  5. Klicken Sie auf Übernehmen.

In Command Manager

  1. Stellen Sie eine Verbindung mit Ihrer Projektquelle her.
  2. Führen Sie das folgende Skript aus:

    ALTER FEATURE FLAG "SENDING LOG TO TELEMETRY SERVER" ON;

Telemetry Server-Konfiguration wird geändert

Apache Kafka-Server

Der Kafka-Server kann durch Ändern von konfiguriert werden server.properties Datei gefunden in:

/opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0

Sowohl Apache Kafka-Server als auch ZooKeeper sollten nach einer Änderung der oben angegebenen Konfigurationsdatei neu gestartet werden.

MicroStrategy Telemetry Server-Konfiguration für Cluster-Umgebungen

Wenn Sie Ihre Intelligence Server geclustert haben und nach dem Upgrade einen separaten Computer zum Ausführen von MicroStrategy Telemetry Server verwenden möchten, führen Sie die folgenden Schritte für jeden Knoten im Cluster durch.

Die Mindestanzahl an Knoten für ein Cluster beträgt 3.

Auf jedem Knoten muss Folgendes installiert sein:

  • MicroStrategy Telemetry Server
  • Apache Kafka
  • Apache Zookeeper

Zookeeper konfigurieren

  1. Zum Ordner navigieren /opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0/config.
  2. Datei bearbeiten zookeeper.properties durch Hinzufügen der folgenden Zeilen:

    Kopieren
    maxClientCnxns=0
    initLimit=5
    syncLimit=2
    server.1=10.27.20.16:2888:3888
    server.2=10.27.20.60:2888:3888
    server.3=10.15.208.236:2888:3888

    Jeder Serverparameter muss eine eindeutige ganzzahlige ID enthalten, wie oben dargestellt.

  3. Zum Ordner wechseln /opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0/config.

  4. Erstellen Sie eine Datei mit dem Namen myid der den identifizierenden Wert aus dem Serverparameternamen in enthält zookeeper.properties Datei.

Kafka konfigurieren

  1. Zum Ordner navigieren /opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0/config.
  2. Datei bearbeiten server.properties, eine Zeile hinzufügen zookeeper.connect=10.27.20.16:2181,10.27.20.60:2181,10.15.208.236:2181 zum Zookeeper-Abschnitt.

    Kopieren
    ############################# Zookeeper #############################
    # Zookeeper connection string (see zookeeper docs for details).
    # This is a comma separated host:port pairs, each corresponding to a zk
    # server. e.g. "127.0.0.1:3000,127.0.0.1:3001,127.0.0.1:3002".
    # You can also append an optional chroot string to the urls to specify the
    # root directory for all kafka znodes.
    # zookeeper.connect=localhost:2181zookeeper.connect=10.27.20.16:2181,10.27.20.60:2181,10.15.208.236:2181
  3. Ändern Sie die broker.id Wert zu einer eindeutigen Ganzzahl von anderen Kafka-Servern (der Standardwert ist 0), z. B. für Knoten 10.27.20.60 verwenden wir Nummer 2.

    Kopieren
    ############################# Server Basics #############################
    # The id of the broker. This must be set to a unique integer for each broker.
    broker.id=2

Starten, anhalten, neu starten und Status von Telemetry Server prüfen

Informationen zum Starten oder Anhalten von Kafka Server und Zookeeper finden Sie unter /opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0/bin und führen Sie einen der folgenden Schritte aus:

  • ./kafka-server-start.sh ../config/server.properties
  • ./kafka-server-stop.sh
  • ./zookeeper-server-start.sh ../config/zookeeper.properties
  • ./zookeeper-server-stop.sh