MicroStrategy ONE
Verificações de integridade na inicialização
Vários serviços foram renomeados no MicroStrategy Lançamento de 2019. Visto que este guia exige a modificação dos arquivos subjacentes, ele usa o nome original dos serviços.
O armazenamento de telemetria (ou seja, consumidor de análise de plataforma) e o produtor de telemetria de identidade (ou seja, Usher Produtor de metadados) dependem e exigem acesso a três componentes para processar logs de telemetria:
- Repositório de Platform Analytics (ou seja, servidor de banco de dados)
- Telemetry Cache (por exemplo, Redis)
- Telemetry Server (por exemplo, Kafka)
Todos os três componentes devem estar em estado íntegro para que o Platform Analytics consiga processar logs de telemetria. Se algum desses três componentes estiver indisponível, o consumidor do Telemetry Store e o produtor do Identity Telemetry serão interrompidos. Portanto, durante a inicialização, tanto o consumidor quanto o produtor executam uma verificação de integridade de todos os três componentes e geram um relatório detalhado com os resultados.
Ocasionalmente, um dos componentes pode estar em processo de inicialização e não completamente em um estado pronto quando a verificação de integridade iniciar. Nessas situações, o consumidor e o produtor realizarão três verificações consecutivas com um atraso de 60 segundos entre cada uma para confirmar se as dependências não estão em estado íntegro.
Para obter mais informações sobre a arquitetura do Platform Analytics, consulte Arquitetura e serviços do Platform Analytics.
Nomeando convenções e localizações
Uma verificação de integridade é realizada durante a inicialização do Consumidor de análise de plataforma e a Usher Produtor de Metadados. Portanto, há dois relatórios de verificação de integridade gerados na pasta log do Platform Analytics que está localizada no caminho padrão de instalação:
- Linux: /optar/MicroStrategy/PlatformAnalytics/log
- Windows: C:\Arquivos de Programas (x86)\MicroStrategy\Análise da plataforma\log
O nome do arquivo identifica se o relatório corresponde ao consumidor ou ao produtor.
Por exemplo,
platform-analytics-consumer-health-check-yyyymmddhhmmss.out
platform-analytics-usher-lookup-producer-health-check-yyyymmddhhmmss.out
Resultados do relatório de verificação de integridade
Cada relatório de verificação de integridade está estruturado em quatro seções:
- Exame de saúde
- Verificação de integridade do Redis
- Exame de saúde de Kafka
- Resumo da verificação de saúde
Cada seção fornece informações diferentes sobre a integridade de seus três componentes.
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.
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 'kafka\\.Kafka' | 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.
Resumo da verificação de saúde
Se todas as verificações forem bem-sucedidas, os resultados serão aprovado. Se houver falha em alguma verificação, você receberá uma FALHA pelo componente correspondente. Em cenários com falhas, use o relatório detalhado acima para investigar suas possíveis causas.