MicroStrategy ONE
Utilitário de verificação de integridade do Platform Analytics
O Platform Analytics Health Check Utility é uma verificação de integridade de ponta a ponta. Este utilitário soluciona problemas em vários componentes necessários para produzir, consumir e relatar telemetria a partir da plataforma. Em particular, esta verificação é recomendada se um relatório em um dos seus projetos não estiver fornecendo telemetria ao warehouse do Platform Analytics.
O Platform Analytics Health Check Utility executa todas as três verificações de funcionamento que ocorrem em Verificações de integridade na inicialização e verificações de telemetria ponta a ponta para verificar se os dados podem ser produzidos pelo Intelligence Server e consumidos pelo Platform Analytics Consumer (Telemetry Store).
Se você estiver usando Linux, o utilitário Platform Analytics Health Check está localizado em /optar/MicroStrategy/PlatformAnalytics/bin. Se você estiver usando Windows, ele está localizado em C:\Arquivos de Programas (x86)\MicroStrategy\Análise da plataforma\bin.
Como executar o utilitário de verificação de integridade do Platform Analytics
Para executar uma verificação de integridade do Platform Analytics de ponta a ponta, execute o verificação de integridade de análise de plataforma.(sh/bat) Utilitário.
As verificações de telemetria ponta a ponta realizadas pelo utilitário Platform Analytics Health Check incluem:
- Exame de saúde
- Verificação de integridade do Redis
- Exame de saúde de Kafka
- Alterar verificação de integridade do diário
- Verificação de integridade das estatísticas
Exame de saúde
Durante a verificação de integridade, há duas verificações sendo executadas:
- O consumidor/produtor consegue se conectar ao banco de dados fornecido durante a instalação e armazenado no arquivo de configuração PAConsumerConfig.yaml? Caso contrário, serão realizados testes adicionais de conectividade de rede para diagnosticar a causa do problema.
- O usuário do banco de dados tem os privilégios necessários? Para obter uma lista completa dos pré-requisitos de instalação, consulte Pré-requisitos do Platform Analytics.
O relatório Health Check fornece uma lista dos privilégios e o status resultante. Se todas as verificações forem bem-sucedidas, a linha final será lida O resultado da verificação de integridade do armazém está íntegro.
Se alguma linha exibir com falha, verifique seu arquivo PAConsumerConfig.yaml e certifique-se de que o banco de dados tem os privilégios corretos.
Se você receber algum dos seguintes erros na verificação de integridade, aqui estão sugestões de soluções alternativas:
Erro de falta de privilégios
Se o usuário do banco de dados armazenado no PAConsumerConfig.yaml arquivo de configuração não tem privilégio(s), então Privilégio INFO [tipo de privilégio]: Fracassado. Para solucionar esse erro, o administrador deve conceder o(s) privilégio(s) que faltam ao usuário do banco de dados e reiniciar o consumidor.
Como conceder os privilégios que faltam:
- Pare o consumidor do Platform Analytics e o Usher Produtor de metadados.
- Conecte-se ao servidor de banco de dados que contém o repositório do Platform Analytics. Execute o seguinte comando, substituindo “someuser” e “somehost” pelas informações específicas do cliente:Copiar
GRANT DROP ON platform_analytics_wh.* TO ‘someuser’@‘somehost’;
- Reinicie o consumidor do Platform Analytics e Usher Produtor de metadados.
Erro de conexão falhada
Se o consumidor ou produtor não conseguir se conectar ao banco de dados usando a configuração especificada no PAConsumerConfig.yaml arquivo de configuração, você poderá ver o seguinte erro:
2018-11-21 21:43:28,793 INFO HealthCheck main - Failed to connect to the database. Retrying after waiting for 60 seconds.
2018-11-21 21:45:31,797 INFO HealthCheck main - Failed to connect to the database. Retrying after waiting for 60 seconds.
2018-11-21 21:47:34,800 ERROR HealthCheck main - Failed to connect to the database using url:jdbc:mysql://XX.Y.Z.1:3306/platform_analytics_wh?rewriteBatchedStatements=true&useLegacyDatetimeCode=false&serverTimezone=UTC. Please double check your connection parameters.
Communications link failure
O arquivo PAConsumerConfig.yaml está preenchido com base nas informações do banco de dados fornecidas durante a instalação. Para corrigir esse erro, conecte-se com a máquina que hospeda o Platform Analytics e confirme que todos os campos no cabeçalho warehouseDbConnection estão corretos no arquivo PAConsumerConfig.yaml.
Erro de senha incorreta do usuário do banco de dados
O consumidor ou produtor não conseguirá se conectar ao banco de dados se a senha criptografada do armazém estiver incorreta. Para gerar uma nova senha criptografada e atualizar a confirmação, consulte Atualizar a senha de usuário do banco de dados configurada para o repositório do Platform Analytics.
Erro de usuário do banco de dados com SSL ativado
O Platform Analytics é compatível com as versões 5.6, 5.7 e 8.0 do MySQL. Para o MySQL 8.0, a conexão SSL está ativada por padrão. Atualmente, o Platform Analytics não é compatível com o SSL para a conexão do usuário do banco de dados com o MySQL. Ao criar o usuário do banco de dados para o Platform Analytics Consumer ou Usher Produtor de metadados, especifique a opção SSL/TLS usando o EXIGIR cláusula.
Como desabilitar o SSL:
- Conecte-se ao repositório do Platform Analytics e execute o seguinte comando:Copiar
show variables like '%ssl%';
-
Se o resultado para 'ter_ssl' é 'SIM' então o SSL está ativado. Crie o usuário com mysql_native_password e NÃO EXIGE NENHUM opções para conectar sem SSL.
CopiarCREATE USER 'test'@'%' IDENTIFIED WITH mysql_native_password BY 'password' REQUIRE NONE;
Verificação de integridade do Redis
A verificação de integridade do Redis determina se o consumidor ou o produtor conseguem se conectar ao servidor do Redis. A verificação fornece estatísticas detalhadas sobre o Redis obtidas durante a inicialização. Se todas as verificações forem bem-sucedidas, a linha final exibirá a mensagem afirmando que o resultado da verificação de integridade do servidor do Redis está adequada.
Se você constatar um erro em sua verificação, certifique-se de que o Redis está sendo executado e que sua configuração está correta no arquivo PAConsumerConfig.yaml.
Se você receber algum dos erros a seguir na verificação de integridade do Redis, veja algumas sugestões de soluções alternativas:
Erro de Interrupção no Redis
Se o consumidor ou o produtor não conseguirem se conectar ao Redis, uma causa possível é que ele esteja em um estado parado. Para resolver esse erro, inicie o MicroStrategy Cache na memória, o consumidor do Platform Analytics e o Usher Produtor de metadados.
Erro de falha na conexão com o Redis
Se o consumidor ou o produtor não conseguir se conectar com o Redis, uma causa possível é que a configuração não esteja correta no arquivo PAConsumerConfig.yaml. Para solucionar esse erro, conecte-se com a máquina que hospeda o Platform Analytics e confirme que todos os campos no cabeçalho redisConnection estão corretos no arquivo PAConsumerConfig.yaml.
É possível que o servidor Redis não tenha conseguido gravar o instantâneo no disco. Se for esse o caso, você pode desabilitar o processo de snapshot RDP no servidor Redis.
-
Pare o Produtor de pesquisa de plataforma-analítica usando o seguinte comando:
Copiar./platform-analytics-usher-lookup-producer.sh stop
-
Pare o consumidor de análise de plataforma usando o seguinte comando:
Copiar./platform-analytics-consumer.sh stop
- Pare o servidor Redis.
- Aplique as seguintes alterações ao arquivo redis.conf:
- Inicie o servidor Redis.
-
Comece o consumidor de análise de plataforma usando o seguinte comando:
Copiar./platform-analytics-consumer.sh start
-
Comece o Produtor de pesquisa de plataforma-analítica usando o seguinte comando:
Copiar./platform-analytics-usher-lookup-producer.sh start
Erro de autenticação de senha habilitada para o Redis
Se o consumidor ou o produtor não conseguir se conectar ao Redis, uma causa possível é que a autenticação de senha esteja habilitada. Por padrão, o Redis não está configurado com a autenticação de senha, mas ela pode ser configurada após a instalação.
Se o Redis tiver sido ativado com a autenticação de senha e a senha não estiver no arquivo de configuração PAConsumerConfig.yaml, o consumidor ou o produtor não conseguirá conectar-se ao Redis. Para resolver esse erro, siga as etapas para Habilite a autenticação por senha no MicroStrategy Cache de Telemetria.
Exame de saúde de Kafka
A verificação de integridade do Kafka garante que o Telemetry Manager (Apache Zookeeper) e o Telemetry Server (Kafka Server) sejam iniciados e conectados. Se todas as verificações forem bem-sucedidas, a linha final exibirá a mensagem afirmando que o resultado da verificação de integridade do cluster do Kafka está adequado.
Visto que o Telemetry Server depende do Telemetry Manager, este deve ser inicializado primeiro.
Se você constatar um erro em sua verificação, certifique-se de que o ZooKeeper e o Kafka foram inicializados.
Como verificar se os servidores ZooKeeper estão rodando em todos os nós:
- No Linux, execute o seguinte comando para executar o PID.Copiar
ps ax | grep java | grep -i QuorumPeerMain | grep -v grep | awk '{print $1}'
- No Windows, abra os Serviços do Windows e verifique se o serviço “Apache ZooKeeper” está em execução.
Como verificar se os servidores Kafka estão rodando em todos os nós:
- No Linux, execute o seguinte comando para executar o PID.Copiar
ps ax | grep -i 'server.prop'| grep java | grep -v grep | awk '{print $1}'
- No Windows, abra os Serviços do Windows e verifique se o serviço “Apache Kafka” está em execução.
Como iniciar o ZooKeeper e o Kafka em todos os nós:
-
No Linux, execute os seguintes comandos no diretório Kafka:
Copiar# Start Zookeeper on all nodes,
./zookeeper-server-start.sh -daemon ../config/zookeeper.properties
# Start Kafka on all nodes,
./kafka-server-start.sh -daemon ../config/server.properties - No Windows, abra os Serviços do Windows e inicie o Apache ZooKeeper e o Apache Kafka.
Se esse for um ambiente agrupado em clusters com vários nós do ZooKeeper e do Kafka, primeiro você deve iniciar todos os nós do ZooKeeper.
Alterar verificação de integridade do diário
A verificação do Change Journal garante que o consumidor do Platform Analytics esteja íntegro. Para esta verificação, você deve fornecer um GUID de projeto e um GUID de relatório para testar. Você será solicitado a modificar a descrição do relatório, o que gera um log do Diário de Mudanças. O teste verifica se o Intelligence Server Producer produziu o log para o tópico Mstr.PlatformAnalytics.ChangeJournal.CubesReportsDashboard Kafka. Em seguida, ele testa se o log é processado e gravado na tabela lu_object do warehouse do Platform Analytics.
Se o registro for encontrado no tópico Kafka apropriado e no warehouse, a linha final será lida O resultado da verificação de integridade do Change Journal está íntegro.
Se você vir um erro em sua verificação, certifique-se de que a sinalização do recurso Messaging Service for Platform Analytics esteja ativada no Intelligence Server e que a propriedade Telemetry Server enabled esteja definida como True no Intelligence Server.
Verifique se o Intelligence Server está configurado para gravar telemetria no Kafka
- Usando o Command Manager, conecte-se ao Intelligence Server.
- Para visualizar o status do sinalizador de recurso, execute o comando:Copiar
LIST ALL FEATURE FLAGS;
- Nos resultados, verifique Serviço de mensagens para análise de plataforma sinalizador de recurso é SOBRE. Se o sinalizador de recurso for DESLIGADO, execute o seguinte comando para ativá-lo:Copiar
ALTER FEATURE FLAG "Messaging Service for Platform Analytics" ON;
-
Para visualizar o status do Servidor de telemetria ativado propriedade, execute o comando:
CopiarLIST PROPERTIES FOR SERVER CONFIGURATION;
-
Nos resultados, verifique Servidor de telemetria ativado propriedade está definida como Verdadeiro. Se a propriedade estiver definida como Falso, execute o comando abaixo:
Substituir <kafka server IP> com o endereço IP do seu servidor Kafka.
Copiar'ALTER SERVER CONFIGURATION ENABLEMESSAGINGSERVICES TRUE CONFIGUREMESSAGINGSERVICES "bootstrap.servers: <kafka server IP>:9092/batch.num.messages:5000/queue.buffering.max.ms:2000";
- Reinicie o servidor do Intelligence.
Verifique se o consumidor do Platform Analytics está funcionando
No Linux:
-
Navegue até a pasta onde o Platform Analytics está instalado.
<Instalar>/PlatformAnalytics/bin
- Execute o seguinte comando:Copiar
./platform-analytics-consumer.sh status
- Inicie ou reinicie o servidor com o seguinte comando:Copiar
./platform-analytics-consumer.sh start
Se reiniciar o servidor não resolver o problema, verifique os logs em <Install> /PlatformAnalytics/log/platform-analytics-consumer.log ou entre em contato MicroStrategy Suporte Técnico e anexe a pasta <Install> /PlatformAnalytics/log para o seu caso.
No Windows:
- Abra os Serviços do Windows usando services.msc.
- Inicie ou reinicie o Armazenamento de Telemetria.
Se reiniciar o servidor não resolver o problema, verifique os logs em <Install> /PlatformAnalytics/log/platform-analytics-consumer.log ou entre em contato MicroStrategy Suporte Técnico e anexe a pasta <Install> /PlatformAnalytics/log para o seu caso.
Verificação de integridade das estatísticas
Essa verificação de integridade garante que o Platform Analytics Consumer possa processar estatísticas de relatório. Você será solicitado a executar o relatório da verificação de funcionamento anterior. Isso gera um log para o tópico Mstr.PlatformAnalytics.IsReportStats. A verificação de funcionamento verifica se o Intelligence Server Producer produziu o registro para Kafka e se ele está no warehouse do Platform Analytics.
Se o registro for encontrado no tópico Kafka apropriado e no warehouse, a linha final será lida O resultado da verificação de integridade das estatísticas está íntegro.
Se você vir um erro na sua verificação, certifique-se de que as Estatísticas estejam habilitadas para o projeto e que os Serviços de Mensagens estejam configurados corretamente.
Verifique se as estatísticas estão habilitadas para o projeto
- Usando o Command Manager, conecte-se ao Intelligence Server.
-
Execute o comando:
Substitua <Project Name> pelo nome do seu projeto.
CopiarLIST ALL PROPERTIES FOR PASTATISTICS IN PROJECT "<Project Name>";
-
Nos resultados, verifique se a propriedade Basic Statistics está definida como Verdadeiro. Se estiver definido para Falso, execute o comando abaixo:
Substitua <Project Name> pelo nome do seu projeto.
CopiarALTER PASTATISTICS BASICSTATS ENABLED DETAILEDREPJOBS TRUE DETAILEDDOCJOBS TRUE JOBSQL TRUE COLUMNSTABLES TRUE IN PROJECT "<Project Name>";
- Reinicie o servidor do Intelligence.
Verifique se o consumidor do Platform Analytics está funcionando
No Linux:
-
Navegue até a pasta onde o Platform Analytics está instalado.
<Instalar>/PlatformAnalytics/bin
- Execute o seguinte comando:Copiar
./platform-analytics-consumer.sh status
- Inicie ou reinicie o servidor com o seguinte comando:Copiar
./platform-analytics-consumer.sh start
Se reiniciar o servidor não resolver o problema, verifique os logs em <Install> /PlatformAnalytics/log/platform-analytics-consumer.log ou entre em contato MicroStrategy Suporte Técnico e anexe a pasta <Install> /PlatformAnalytics/log para o seu caso.
No Windows:
- Abra os Serviços do Windows usando services.msc.
- Inicie ou reinicie o Armazenamento de Telemetria.
Se reiniciar o servidor não resolver o problema, verifique os logs em <Install> /PlatformAnalytics/log/platform-analytics-consumer.log ou entre em contato MicroStrategy Suporte Técnico e anexe a pasta <Install> /PlatformAnalytics/log para o seu caso.