Strategy ONE
MicroStrategy Telemetry Server
- Windows
- Linux
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:
- Habilitar o MicroStrategy Telemetry Server
- Ativar o recurso de envio de log para o servidor de telemetria
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
- Faça login usando a conta de administrador.
- Abra Preferências do usuário > Padrões do projeto.
- Localizar Enviando log ao Telemetry Server na seção Recursos para Feedback do Cliente.
- Selecione Ativação no menu suspenso.
- Clique em Apply (Aplicar).
No Command Manager
- Conecte-se à origem do projeto.
-
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
- Navegue até a pasta
C:\Program Files (x86)\MicroStrategy\Telemetry Server\Kafka\kafka_2.13-2.6.1\config
. -
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çãodataDir = C:\Program Files (x86)\MicroStrategy\Telemetry Server\tmp\zookeeper
-
Ir para a pasta
C:\Program Files (x86)\MicroStrategy\TelemetryServer\Kafka\kafka_2.13-2.6.1\config
. -
Crie um arquivo de texto chamado
myid
contendo o valor de identificação do nome do parâmetro do servidor nozookeeper.properties
arquivo.
Configurar o Kafka
- Navegue até a pasta
C:\Program Files (x86)\MicroStrategy\Telemetry Server\Kafka\kafka_2.13-2.6.1\config
. -
Editar arquivo
server.properties
, adicione uma linhazookeeper.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
-
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:
- Habilitar o MicroStrategy Telemetry Server
- Ativar o recurso de envio de log para o servidor de telemetria
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
- Faça login usando a conta de administrador.
- Abra Preferências do usuário > Padrões do projeto.
- Localizar Enviando log ao Telemetry Server na seção Recursos para Feedback do Cliente.
- Selecione Ativação no menu suspenso.
- Clique em Apply (Aplicar).
No Command Manager
- Conecte-se à origem do projeto.
-
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
- Navegue até a pasta
/opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0/config
. -
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.
-
Ir para a pasta
/opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0/config
. -
Crie um arquivo chamado
myid
contendo o valor de identificação do nome do parâmetro do servidor nozookeeper.properties
arquivo.
Configurar o Kafka
- Navegue até a pasta
/opt/MicroStrategy/TelemetryServer/Kafka/kafka_2.13-2.6.0/config
. -
Editar arquivo
server.properties
, adicione uma linhazookeeper.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
-
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