Strategy ONE

MicroStrategy Telemetry Server

MicroStrategy Telemetry Server no Windows

O Telemetry Server é um componente acoplado ao Intelligence Server durante as instalações e atualizações. O Telemetry Server já vem configurado e é executado automaticamente após a conclusão da instalação.

Após a instalação, você verá que os seguintes serviços são iniciados automaticamente:

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

Por padrão, a MicroStrategy ainda enviará os logs de diagnóstico do Intelligence Server ao disco local. Os logs de diagnóstico serão enviados ao Telemetry Server após você realizar o seguinte:

Posteriormente, você verá os arquivos de log do Kafka criados na pasta de instalação do Kafka:

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

Tópicos diferentes do Kafka serão criados para armazenar dados para diferentes componentes do MicroStrategy.

Configurando o Telemetry Server após a atualização

Por padrão, o MicroStrategy Telemetry Server é instalado junto com a atualização do Intelligence Server.

Fluxo de trabalho do Telemetry Server para Intelligence Server

  • O Intelligence Server é o Kafka Producer e pode ser implantado como um único nó ou cluster.
  • O Kafka Server pode ser implantado como um único nó ou cluster.

Habilitar o MicroStrategy Telemetry Server

A configuração do Telemetry Server é salva na configuração do MicroStrategy Intelligence Server. Ele pode ser habilitado ou desabilitado rapidamente, sem reiniciar o Intelligence Server.

Scripts do Command Manager para Telemetry Server

Para verificar se o Telemetry Server está habilitado, execute:

LIST ALL PROPERTIES FOR SERVER CONFIGURATION;

Para habilitar o Telemetry Server por meio do Command Manager, execute:

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

No exemplo acima, defina:

  • bootstrap.servers: para o endereço IP e o número da porta do seu servidor Kafka.
  • batch.num.messages: para o número de mensagens a serem enviadas em um lote ao usar o modo assíncrono.
  • queue.buffering.max.ms: para o tempo máximo para armazenar dados em buffer ao usar o modo assíncrono.

Você pode especificar mais definições de configuração do Kafka Producer neste comando seguindo o mesmo formato.

Ativar o recurso de envio de log para o servidor de telemetria

Você pode ativar o recurso de envio de log ao servidor de telemetria usando o MicroStrategy Web ou o Command Manager.

No MicroStrategy Web

  1. Faça login usando a conta de administrador.
  2. Abra Preferências do usuário > Padrões do projeto.
  3. Localizar Enviando log ao Telemetry Server na seção Recursos para Feedback do Cliente.
  4. Selecione Ativação no menu suspenso.
  5. Clique em Apply (Aplicar).

No Command Manager

  1. Conecte-se à origem do projeto.
  2. Execute o seguinte:

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

Modificando a configuração do servidor de telemetria

Apache Kafka Server

O Kafka Server pode ser configurado modificando o server.properties arquivo encontrado em:

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

Tanto o Apache Kafka Server quanto o ZooKeeper devem ser reiniciados após a modificação do arquivo de configuração acima.

Configuração do MicroStrategy Telemetry Server para ambientes em cluster

Se você agrupou seus Intelligence Servers em cluster e deseja usar uma máquina separada para executar o MicroStrategy Telemetry Server após a atualização, conclua as etapas a seguir para cada nó no cluster.

O número mínimo de nós para um cluster são 3.

Cada nó deve ter o seguinte instalado:

  • MicroStrategy Telemetry Server
  • Apache Kafka
  • Apache Zookeeper

Configurar o Zookeeper

  1. Navegue até a pasta C:\Program Files (x86)\MicroStrategy\Telemetry Server\Kafka\kafka_2.13-2.6.1\config.
  2. Editar arquivo zookeeper.properties adicionando as seguintes linhas:

    clientPort=2181

    dataDir=C: \\ Arquivos de Programas (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

    Cada parâmetro de servidor deve conter um identificador inteiro único como mostrado acima. Você atribui o ID do servidor a cada máquina criando um arquivo de texto chamado myid, um para cada servidor, que reside no diretório de dados desse servidor, conforme especificado pelo parâmetro do arquivo de configuração dataDir = C:\Program Files (x86)\MicroStrategy\Telemetry Server\tmp\zookeeper

  3. Ir para a pasta C:\Program Files (x86)\MicroStrategy\TelemetryServer\Kafka\kafka_2.13-2.6.1\config.

  4. Crie um arquivo de texto chamado myid contendo o valor de identificação do nome do parâmetro do servidor no zookeeper.properties arquivo.

Configurar o Kafka

  1. Navegue até a pasta C:\Program Files (x86)\MicroStrategy\Telemetry Server\Kafka\kafka_2.13-2.6.1\config.
  2. Editar arquivo server.properties, adicione uma linha zookeeper.connect=10.27.20.16:2181,10.27.20.60:2181,10.15.208.236:2181 para a seção Zookeeper.

    ############################# Zookeeper #############################

    # string de conexão do Zookeeper (consulte os documentos do zookeeper para obter detalhes).

    # Isso é um par de host:porta separados por vírgula, cada um correspondendo a um zk

    # servidor. Por exemplo, "127.0.0.1:3000,127.0.0.1:3001,127.0.0.1:3002".

    # Você também pode acrescentar uma string chroot opcional aos endereços para especificar o

    diretório # root para todos os znodes kafka.

    # zookeeper.connect=localhost:2181

    zookeeper.connect=10.27.20.16:2181,10.27.20.60:2181,10.15.208.236:2181

  3. Modifique o broker.id valor para um número inteiro exclusivo de outros servidores Kafka (o valor padrão é 0), como para o nó 10.27.20.60 usamos o número 2.

    ############################# Server Basics #############################

    # O ID do agente. Esse número deve ser definido como um inteiro exclusivo para cada agente.

    broker.id=2

Iniciar, Parar, Reiniciar e Verificar Status do Servidor de Telemetria

Nas instalações do Windows, abra Gerenciador de Tarefas > Serviços para iniciar, parar, reiniciar e verificar o status dos componentes do Telemetry Server.

MicroStrategy Telemetry Server no Linux

O Telemetry Server é um componente acoplado ao Intelligence Server durante as instalações e atualizações. O Telemetry Server já vem configurado e é executado automaticamente após a conclusão da instalação.

Após a instalação, você verá que os seguintes serviços são iniciados automaticamente:

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

Por padrão, a MicroStrategy ainda enviará os logs de diagnóstico do Intelligence Server ao disco local. Os logs de diagnóstico serão enviados ao Telemetry Server depois que você realizar o seguinte:

Posteriormente, você verá os arquivos de log do Kafka criados na pasta de instalação do Kafka:

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

Tópicos diferentes do Kafka serão criados para armazenar dados para diferentes componentes do MicroStrategy.

Configurando o Telemetry Server após a atualização

Por padrão, o MicroStrategy Telemetry Server é instalado junto com a atualização do Intelligence Server.

Fluxo de trabalho do Telemetry Server para Intelligence Server

  • O Intelligence Server é o Kafka Producer e pode ser implantado como um único nó ou cluster.
  • O Kafka Server pode ser implantado como um único nó ou cluster.

Habilitar o MicroStrategy Telemetry Server

A configuração do Telemetry Server é salva na configuração do MicroStrategy Intelligence Server. Ele pode ser habilitado ou desabilitado rapidamente, sem reiniciar o Intelligence Server.

Scripts do Command Manager para Telemetry Server

Para verificar se o Telemetry Server está habilitado, execute:

LIST ALL PROPERTIES FOR SERVER CONFIGURATION;

Para habilitar o Telemetry Server por meio do Command Manager, execute:

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

No exemplo acima, defina:

  • bootstrap.servers: para o endereço IP e o número da porta do seu servidor Kafka.
  • batch.num.messages: para o número de mensagens a serem enviadas em um lote ao usar o modo assíncrono.
  • queue.buffering.max.ms: para o tempo máximo para armazenar dados em buffer ao usar o modo assíncrono.

Você pode especificar mais definições de configuração do Kafka Producer neste comando seguindo o mesmo formato.

Ativar o recurso de envio de log para o servidor de telemetria

Você pode ativar o recurso de envio de log ao servidor de telemetria usando o MicroStrategy Web ou o Command Manager.

No MicroStrategy Web

  1. Faça login usando a conta de administrador.
  2. Abra Preferências do usuário > Padrões do projeto.
  3. Localizar Enviando log ao Telemetry Server na seção Recursos para Feedback do Cliente.
  4. Selecione Ativação no menu suspenso.
  5. Clique em Apply (Aplicar).

No Command Manager

  1. Conecte-se à origem do projeto.
  2. Execute o seguinte:

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

Modificando a configuração do servidor de telemetria

Apache Kafka Server

O Kafka Server pode ser configurado modificando o server.properties arquivo encontrado em:

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

Tanto o Apache Kafka Server quanto o ZooKeeper devem ser reiniciados após a modificação do arquivo de configuração acima.

Configuração do MicroStrategy Telemetry Server para ambientes em cluster

Se você agrupou seus Intelligence Servers em cluster e deseja usar uma máquina separada para executar o MicroStrategy Telemetry Server após a atualização, conclua as etapas a seguir para cada nó no cluster.

O número mínimo de nós para um cluster são 3.

Cada nó deve ter o seguinte instalado:

  • MicroStrategy Telemetry Server
  • Apache Kafka
  • Apache Zookeeper

Configurar o Zookeeper

  1. Navegue até a pasta /opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0/config.
  2. Editar arquivo zookeeper.properties adicionando as seguintes linhas:

    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

    Cada parâmetro de servidor deve conter um identificador inteiro único como mostrado acima.

  3. Ir para a pasta /opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0/config.

  4. Crie um arquivo chamado myid contendo o valor de identificação do nome do parâmetro do servidor no zookeeper.properties arquivo.

Configurar o Kafka

  1. Navegue até a pasta /opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0/config.
  2. Editar arquivo server.properties, adicione uma linha zookeeper.connect=10.27.20.16:2181,10.27.20.60:2181,10.15.208.236:2181 para a seção Zookeeper.

    ############################# Zookeeper #############################

    # string de conexão do Zookeeper (consulte os documentos do zookeeper para obter detalhes).

    # Isso é um par de host:porta separados por vírgula, cada um correspondendo a um zk

    # servidor. Por exemplo, "127.0.0.1:3000,127.0.0.1:3001,127.0.0.1:3002".

    # Você também pode acrescentar uma string chroot opcional aos endereços para especificar o

    diretório # root para todos os znodes kafka.

    # zookeeper.connect=localhost:2181

    zookeeper.connect=10.27.20.16:2181,10.27.20.60:2181,10.15.208.236:2181

  3. Modifique o broker.id valor para um número inteiro exclusivo de outros servidores Kafka (o valor padrão é 0), como para o nó 10.27.20.60, usamos o número 2.

    ############################# Server Basics #############################

    # O ID do agente. Esse número deve ser definido como um inteiro exclusivo para cada agente.

    broker.id=2

Iniciar, Parar, Reiniciar e Verificar Status do Servidor de Telemetria

Para iniciar ou parar o Kafka Server e o Zookeeper, vá para /opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0/bin e execute um dos seguintes procedimentos:

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