MicroStrategy ONE

MicroStrategy Telemetry Server

  • Windows
  • Linux

Windows 上の MicroStrategy Telemetry Server

Telemetry Server は、Intelligence Server と同時にインストールおよびアップグレードされるコンポーネントです。Telemetry Server はすぐに使用できるように構成されており、インストールが完了すると自動的に実行されます。

インストール後、以下のサービスが自動的に起動されるのが分かります。

  • アパッチカフカ（C:\Program Files (x86)\MicroStrategy\Telemetry Server\Kafka\kafka_2.13-2.6.1）
  • Apache ズーキーパー（C:\Program Files (x86)\MicroStrategy\Telemetry Server\Kafka\kafka_2.13-2.6.1）

デフォルトでは、MicroStrategy は Intelligence Server の診断ログを、ローカル ディスクに送るようになっています。次のように実行すると、Telemetry Serverに診断ログを送信するようになります。

以降、Kafka ログ ファイルは Kafka インストール フォルダーに作成されます。

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

MicroStrategy の各コンポーネントのデータを保存するために、それぞれ別の Kafka トピックが作成されます。

アップグレード後の Telemetry Server の構成

デフォルトでは、MicroStrategy Telemetry Server は Intelligence Server のアップグレードと共にインストールされます。

Telemetry Server Workflow for Intelligence Server

  • Intelligence Server は Kafka Producer であり、1 つのノードまたはクラスターとして配置できます。

  • Kafka サーバーは、1 つのノードまたはクラスターとして配置できます。

MicroStrategy Telemetry Server の有効化

Telemetry Server の設定は、MicroStrategy Intelligence Server の設定内に保存されます。いつでも有効/無効を切り替えることができ、Intelligence Server を再始動する必要はありません。

Telemetry Server の Command Manager スクリプト

Telemetry Server が有効になっているかどうかを確認するには、次のコマンドを実行します。

LIST ALL PROPERTIES FOR SERVER CONFIGURATION;

Command Manager を使用して Telemetry Server を有効化するには:

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

上記の例で、以下のように設定します。

  • bootstrap.servers : Kafka サーバーの IP アドレスとポート番号。
  • batch.num.messages : 非同期モードを使用する場合に 1 回のバッチで送信するメッセージの数。
  • queue.buffering.max.ms : 非同期モードを使用するときにデータをバッファリングする最大時間。

このコマンドで、同じフォーマットに従って Kafka Producer の構成設定をさらに指定することができます。

ログを Telemetry Server に送信する機能をオンにする

ログを Telemetry Server に送信する機能をオンにするためには、MicroStrategy Web または Command Manager を使います。

MicroStrategy Web で実行する方法

  1. Administrator アカウントでログインします。
  2. オープンユーザー設定 > プロジェクトのデフォルト。
  3. 位置特定テレメトリサーバーにログを送信顧客フィードバック機能のセクションにあります。
  4. 選択の上ドロップダウンメニューから選択します。
  5. クリック適用する。

Command Manager で実行する方法

  1. プロジェクト ソースに接続します。

  2. 次のコマンドを実行してください:

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

Telemetry Server の設定の変更

Apache Kafka サーバー

Kafkaサーバーは、server.propertiesファイルが見つかりました:

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

Apache Kafka サーバーと ZooKeeper は両方とも、上記の構成ファイルを変更した後、再起動する必要があります。

クラスタ環境用の MicroStrategy Telemetry Server の構成

Intelligence Server がクラスター化されていて、アップグレード後に別のコンピューターを使用して MicroStrategy Telemetry Server を実行したい場合は、クラスター内の各ノードで次の手順を実行します。

クラスターの最小ノード数は3。

各ノードに、以下のものがインストールされている必要があります。

  • MicroStrategy Telemetry Server
  • Apache Kafka
  • Apache Zookeeper

Zookeeper の構成

  1. フォルダを参照C:\Program Files (x86)\MicroStrategy\Telemetry Server\Kafka\kafka_2.13-2.6.1\config。

  2. ファイルを編集zookeeper.properties次の行を追加します。

    コピー 
    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

    上記に示すように、各サーバー パラメーターには固有の整数 ID が必要です。それぞれのマシンにサーバーIDを割り当てるには、次のテキストファイルを作成します。myid各サーバーごとに1つあり、構成ファイルのパラメータで指定されたサーバーのデータディレクトリに存在します。dataDir = C:\Program Files (x86)\MicroStrategy\Telemetry Server\tmp\zookeeper

  3. フォルダへ移動C:\Program Files (x86)\MicroStrategy\TelemetryServer\Kafka\kafka_2.13-2.6.1\config。

  4. という名前のテキストファイルを作成しますmyidサーバーパラメータ名の識別値を含むzookeeper.propertiesファイル。

Kafka の構成

  1. フォルダを参照C:\Program Files (x86)\MicroStrategy\Telemetry Server\Kafka\kafka_2.13-2.6.1\config。

  2. ファイルを編集server.properties行を追加zookeeper.connect=10.27.20.16:2181,10.27.20.60:2181,10.15.208.236:2181飼育係のセクションへ。

    コピー 
    ############################# 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. 変更するbroker.id値を他の Kafka サーバーからの一意の整数に設定します (デフォルト値は 0)。たとえば、ノード 10.27.20.60 の場合は番号 2 を使用します。

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

Telemetry Server の起動、停止、再起動、ステータス チェック

Windowsインストールの場合は、タスクマネージャー > サービス Telemetry Server コンポーネントを起動、停止、再起動し、ステータスを確認します。

Linux 上の MicroStrategy Telemetry Server

Telemetry Server は、Intelligence Server と同時にインストールおよびアップグレードされるコンポーネントです。Telemetry Server はすぐに使用できるように構成されており、インストールが完了すると自動的に実行されます。

インストール後、以下のサービスが自動的に起動されるのが分かります。

  • アパッチカフカ(/opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0)
  • Apache ズーキーパー(/opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0)

デフォルトでは、MicroStrategy は Intelligence Server の診断ログを、ローカル ディスクに送るようになっています。次のように実行すると、Telemetry Server に診断ログを送信するようになります。

以降、Kafka ログ ファイルは Kafka インストール フォルダーに作成されます。

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

MicroStrategy の各コンポーネントのデータを保存するために、それぞれ別の Kafka トピックが作成されます。

アップグレード後の Telemetry Server の構成

デフォルトでは、MicroStrategy Telemetry Server は Intelligence Server のアップグレードと共にインストールされます。

Telemetry Server Workflow for Intelligence Server

  • Intelligence Server は Kafka Producer であり、1 つのノードまたはクラスターとして配置できます。

  • Kafka サーバーは、1 つのノードまたはクラスターとして配置できます。

MicroStrategy Telemetry Server の有効化

Telemetry Server の設定は、MicroStrategy Intelligence Server の設定内に保存されます。いつでも有効/無効を切り替えることができ、Intelligence Server を再始動する必要はありません。

Telemetry Server の Command Manager スクリプト

Telemetry Server が有効になっているかどうかを確認するには、次のコマンドを実行します。

LIST ALL PROPERTIES FOR SERVER CONFIGURATION;

Command Manager を使用して Telemetry Server を有効化するには:

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

上記の例で、以下のように設定します。

  • bootstrap.servers : Kafka サーバーの IP アドレスとポート番号。
  • batch.num.messages : 非同期モードを使用する場合に 1 回のバッチで送信するメッセージの数。
  • queue.buffering.max.ms : 非同期モードを使用するときにデータをバッファリングする最大時間。

このコマンドで、同じフォーマットに従って Kafka Producer の構成設定をさらに指定することができます。

ログを Telemetry Server に送信する機能をオンにする

ログを Telemetry Server に送信する機能をオンにするためには、MicroStrategy Web または Command Manager を使います。

MicroStrategy Web で実行する方法

  1. Administrator アカウントでログインします。
  2. オープンユーザー設定 > プロジェクトのデフォルト。
  3. 位置特定テレメトリサーバーにログを送信顧客フィードバック機能のセクションにあります。
  4. 選択の上ドロップダウンメニューから選択します。
  5. クリック適用する。

Command Manager で実行する方法

  1. プロジェクト ソースに接続します。

  2. 次のコマンドを実行してください:

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

Telemetry Server の設定の変更

Apache Kafka サーバー

Kafkaサーバーは、server.propertiesファイルが見つかりました:

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

Apache Kafka サーバーと ZooKeeper は両方とも、上記の構成ファイルを変更した後、再起動する必要があります。

クラスタ環境用の MicroStrategy Telemetry Server の構成

Intelligence Server がクラスター化されていて、アップグレード後に別のコンピューターを使用して MicroStrategy Telemetry Server を実行したい場合は、クラスター内の各ノードで次の手順を実行します。

クラスターの最小ノード数は3。

各ノードに、以下のものがインストールされている必要があります。

  • MicroStrategy Telemetry Server
  • Apache Kafka
  • Apache Zookeeper

Zookeeper の構成

  1. フォルダを参照/opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0/config。

  2. ファイルを編集zookeeper.properties次の行を追加します。

    コピー 
    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

    上記に示すように、各サーバー パラメーターには固有の整数 ID が必要です。

  3. フォルダへ移動/opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0/config。

  4. という名前のファイルを作成しますmyidサーバーパラメータ名の識別値を含むzookeeper.propertiesファイル。

Kafka の構成

  1. フォルダを参照/opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0/config。

  2. ファイルを編集server.properties行を追加zookeeper.connect=10.27.20.16:2181,10.27.20.60:2181,10.15.208.236:2181飼育係のセクションへ。

    コピー 
    ############################# 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. 変更するbroker.id値を他の Kafka サーバーからの一意の整数に設定します (デフォルト値は 0)。たとえば、ノード 10.27.20.60 の場合は番号 2 を使用します。

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

Telemetry Server の起動、停止、再起動、ステータス チェック

Kafka ServerとZookeeperを起動または停止するには、 /opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0/bin次のいずれかを実行します。

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