MicroStrategy ONE

MicroStrategy Telemetry Server

MicroStrategy Telemetry Server sous Windows

Telemetry Server est un composant qui est couplé à Intelligence Server lors des installations et des mises à niveau. Telemetry Server est configuré prêt à l'emploi et s'exécute automatiquement à la fin de l'installation.

Après l'installation, les services suivants sont automatiquement lancés :

  • 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 )

Par défaut, MicroStrategy envoie les journaux de diagnostic d'Intelligence Server sur le disque local. Les journaux de diagnostic seront envoyés à Telemetry Server Server après que vous avez effectué les actions suivantes :

Vous verrez ensuite les fichiers journaux Kafka créés dans le dossier d'installation de Kafka :

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

Différentes rubriques Kafka seront créées en vue de stocker des données pour divers composants MicroStrategy.

Configuration de Telemetry Server après la mise à niveau

Par défaut, MicroStrategy Telemetry Server est installé avec la mise à niveau du serveur Intelligence.

Workflow Telemetry Server pour Intelligence Server

  • Intelligence Server est le producteur Kafka et peut être déployé en tant que nœud unique ou cluster.
  • Kafka Server peut être déployé en tant que nœud unique ou en tant que cluster.

Activer MicroStrategy Telemetry Server

La configuration Telemetry Server est enregistrée dans la configuration MicroStrategy Intelligence Server. Elle peut être activée ou désactivée à la volée, sans redémarrer votre Intelligence Server.

Scripts Command Manager pour Telemetry Server

Pour vérifier si Telemetry Server est activé, exécutez :

LIST ALL PROPERTIES FOR SERVER CONFIGURATION;

Pour activer Telemetry Server via Command Manager, exécutez :

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

Dans l'exemple ci-dessus, définir :

  • bootstrap.servers: vers votre adresse IP et votre numéro de port Kafka Server.
  • batch.num.messages: au nombre de messages à envoyer en un seul lot lors de l'utilisation du mode asynchrone.
  • queue.buffering.max.ms: sur la durée maximale de mise en mémoire tampon des données lors de l'utilisation du mode asynchrone.

Dans cette commande, vous pouvez spécifier davantage de paramètres de configuration pour Kafka Producer en suivant le même format.

Activer la fonctionnalité Envoi de journal vers Telemetry Server

Vous pouvez activer la fonctionnalité Envoi du journal vers Telemetry Server en utilisant MicroStrategy Web ou Command Manager.

Depuis MicroStrategy Web

  1. Connectez-vous en utilisant un compte Administrateur.
  2. Ouvrir l'utilisateur Préférences > Valeurs par défaut du projet.
  3. Localiser Envoi du journal à Telemetry Server dans la section Fonctionnalités pour les commentaires client.
  4. Sélectionner Le dans le menu déroulant.
  5. Cliquez sur Appliquer.

Depuis Command Manager

  1. Connectez-vous à votre source de projet.
  2. Exécutez la commande suivante :

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

Modification de la configuration Telemetry Server

Apache Kafka Server

Kafka Server peut être configuré en modifiant server.properties fichier trouvé dans :

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

Apache Kafka Server et ZooKeeper doivent être redémarrés après avoir modifié le fichier de configuration ci-dessus.

Configuration de MicroStrategy Telemetry Server pour les environnements en cluster

Si vous avez mis en cluster vos serveurs Intelligence Server et souhaitez utiliser un ordinateur séparé pour exécuter MicroStrategy Telemetry Server après la mise à niveau, effectuez les étapes suivantes pour chaque nœud du cluster.

Le nombre minimum de nœuds pour un cluster est de 3.

Chaque nœud doit avoir les éléments suivants installés :

  • MicroStrategy Telemetry Server
  • Apache Kafka
  • Apache ZooKeeper

Configurez Zookeeper

  1. Parcourir jusqu'au dossier C:\Program Files (x86)\MicroStrategy\Telemetry Server\Kafka\kafka_2.13-2.6.1\config.
  2. Modifier le fichier zookeeper.properties en ajoutant les lignes suivantes :

    Copier
    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

    Chaque paramètre de serveur doit contenir un identifiant entier unique, comme indiqué ci-dessus. Vous attribuez l'ID de serveur à chaque ordinateur en créant un fichier texte nommé myid, un pour chaque serveur, qui réside dans le répertoire de données de ce serveur, comme indiqué par le paramètre de fichier de configuration dataDir = C:\Program Files (x86)\MicroStrategy\Telemetry Server\tmp\zookeeper

  3. Accéder au dossier C:\Program Files (x86)\MicroStrategy\TelemetryServer\Kafka\kafka_2.13-2.6.1\config.

  4. Créez un fichier texte nommé myid contenant la valeur d'identification du nom du paramètre de serveur dans zookeeper.properties fichier.

Configurez Kafka

  1. Parcourir jusqu'au dossier C:\Program Files (x86)\MicroStrategy\Telemetry Server\Kafka\kafka_2.13-2.6.1\config.
  2. Modifier le fichier server.properties, ajouter une ligne zookeeper.connect=10.27.20.16:2181,10.27.20.60:2181,10.15.208.236:2181 à la section Zookeeper.

    Copier
    ############################# 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. Modifier broker.id à un entier unique des autres serveurs Kafka (la valeur par défaut est 0), par exemple pour le nœud 10.27.20.60, nous utilisons le numéro 2.

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

Démarrer, arrêter, redémarrer et vérifier l'état de Telemetry Server

Sur les installations Windows, ouvrez Gestionnaire des tâches > Services pour démarrer, arrêter, redémarrer et vérifier l'état des composants Telemetry Server.

MicroStrategy Telemetry Server sous Linux

Telemetry Server est un composant qui est couplé à Intelligence Server lors des installations et des mises à niveau. Telemetry Server est configuré prêt à l'emploi et s'exécute automatiquement à la fin de l'installation.

Après l'installation, les services suivants sont automatiquement lancés :

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

Par défaut, MicroStrategy envoie les journaux de diagnostic d'Intelligence Server sur le disque local. Les journaux de diagnostic seront envoyés à Telemetry Server après que vous avez effectué les actions suivantes :

Vous verrez ensuite les fichiers journaux Kafka créés dans le dossier d'installation de Kafka :

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

Différentes rubriques Kafka seront créées en vue de stocker des données pour divers composants MicroStrategy.

Configuration de Telemetry Server après la mise à niveau

Par défaut, MicroStrategy Telemetry Server est installé avec la mise à niveau du serveur Intelligence.

Workflow Telemetry Server pour Intelligence Server

  • Intelligence Server est le producteur Kafka et peut être déployé en tant que nœud unique ou cluster.
  • Kafka Server peut être déployé en tant que nœud unique ou en tant que cluster.

Activer MicroStrategy Telemetry Server

La configuration Telemetry Server est enregistrée dans la configuration MicroStrategy Intelligence Server. Elle peut être activée ou désactivée à la volée, sans redémarrer votre Intelligence Server.

Scripts Command Manager pour Telemetry Server

Pour vérifier si Telemetry Server est activé, exécutez :

LIST ALL PROPERTIES FOR SERVER CONFIGURATION;

Pour activer Telemetry Server via Command Manager, exécutez :

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

Dans l'exemple ci-dessus, définir :

  • bootstrap.servers: vers votre adresse IP et votre numéro de port Kafka Server.
  • batch.num.messages: au nombre de messages à envoyer en un seul lot lors de l'utilisation du mode asynchrone.
  • queue.buffering.max.ms: sur la durée maximale de mise en mémoire tampon des données lors de l'utilisation du mode asynchrone.

Dans cette commande, vous pouvez spécifier davantage de paramètres de configuration pour Kafka Producer en suivant le même format.

Activer la fonctionnalité Envoi de journal vers Telemetry Server

Vous pouvez activer la fonctionnalité Envoi du journal vers Telemetry Server en utilisant MicroStrategy Web ou Command Manager.

Depuis MicroStrategy Web

  1. Connectez-vous en utilisant un compte Administrateur.
  2. Ouvrir l'utilisateur Préférences > Valeurs par défaut du projet.
  3. Localiser Envoi du journal à Telemetry Server dans la section Fonctionnalités pour les commentaires client.
  4. Sélectionner Le dans le menu déroulant.
  5. Cliquez sur Appliquer.

Depuis Command Manager

  1. Connectez-vous à votre source de projet.
  2. Exécutez la commande suivante :

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

Modification de la configuration Telemetry Server

Apache Kafka Server

Kafka Server peut être configuré en modifiant server.properties fichier trouvé dans :

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

Apache Kafka Server et ZooKeeper doivent être redémarrés après avoir modifié le fichier de configuration ci-dessus.

Configuration de MicroStrategy Telemetry Server pour les environnements en cluster

Si vous avez mis en cluster vos serveurs Intelligence Server et souhaitez utiliser un ordinateur séparé pour exécuter MicroStrategy Telemetry Server après la mise à niveau, effectuez les étapes suivantes pour chaque nœud du cluster.

Le nombre minimum de nœuds pour un cluster est de 3.

Chaque nœud doit avoir les éléments suivants installés :

  • MicroStrategy Telemetry Server
  • Apache Kafka
  • Apache ZooKeeper

Configurez Zookeeper

  1. Parcourir jusqu'au dossier /opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0/config.
  2. Modifier le fichier zookeeper.properties en ajoutant les lignes suivantes :

    Copier
    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

    Chaque paramètre de serveur doit contenir un identifiant entier unique, comme indiqué ci-dessus.

  3. Accéder au dossier /opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0/config.

  4. Créez un fichier nommé myid contenant la valeur d'identification du nom du paramètre de serveur dans zookeeper.properties fichier.

Configurez Kafka

  1. Parcourir jusqu'au dossier /opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0/config.
  2. Modifier le fichier server.properties, ajouter une ligne zookeeper.connect=10.27.20.16:2181,10.27.20.60:2181,10.15.208.236:2181 à la section Zookeeper.

    Copier
    ############################# 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. Modifier broker.id à un entier unique des autres serveurs Kafka (la valeur par défaut est 0), par exemple pour le nœud 10.27.20.60, nous utilisons le numéro 2.

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

Démarrer, arrêter, redémarrer et vérifier l'état de Telemetry Server

Pour démarrer ou arrêter Kafka Server et Zookeeper, rendez-vous sur /opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0/bin et exécutez l'une des actions suivantes :

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