Problemas de dados do Zookeeper

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. informações

Sintoma

Problemas relacionados a dados, geralmente chamados de problemas de fiação, podem se manifestar como um dos seguintes sintomas:

  • Falhas durante a inicialização dos servidores de gerenciamento
  • Falhas na implantação
  • Erros do Datastore na interface
  • Problemas de conectividade entre data centers entre processadores de mensagens e servidores de gerenciamento
  • Analytics sem dados

Esses problemas não estão relacionados à infraestrutura do ZooKeeper, mas aos dados inválidos disponíveis na árvore do ZooKeeper.

Causas possíveis

As causas mais comuns desse problema são:

  1. Nós conectados à região ou ao nome do pod errado durante a instalação devido a erros no arquivo de instalação silenciosa.
  2. Uma instalação com falha de um componente cria registros duplicados quando ele é reinstalado várias vezes. Nesse caso, a limpeza é necessária para remover o registro com os UUIDs errados.

Diagnóstico

Para diagnosticar, colete os seguintes dados:

  1. Diagrama de topologia, com endereços IP e nome do host de cada nó e qual componente da Apigee existe no nó. Um mapeamento como o seguinte, usando o perfil da instalação da Apigee, seria mais útil: 
    DC-1
DS: ip1 hostname
DS: ip2 hostname
DS: ip3 hostname
MS: ip4 hostname
RMP: ip5 hostname
RMP: ip6 hostname
SAX: ip7 hostname

DC-2
DS: ip8 hostname
DS: ip9 hostname
DS: ip10 hostname
MS: ip11 hostname
RMP: ip12 hostname
RMP: ip13 hostname
SAX: ip14 hostname
  2. Gere a saída da árvore do ZooKeeper para verificar a fiação: 
    /opt/apigee/apigee-zookeeper/contrib/zk-tree.sh > zk-tree-output.txt
  3. Para facilitar a verificação dos dados na árvore do ZooKeeper, execute as seguintes chamadas da API de gerenciamento para conseguir a lista de UUIDs do servidor em cada um dos data centers:

    Servidores de gateway

    curl -u sysadmin@email.com "http://management-server-host:8080/v1/servers?pod=gateway&region=region-name"

    Servidores centrais

    curl -u sysadmin@email.com "http://management-server-host:8080/v1/servers?pod=central&region=region-name"

    Servidores do Analytics

    curl -u sysadmin@email.com "http://management-server-host:8080/v1/servers?pod=analytics&region=region-name"
  4. Verifique os UUIDs de cada componente e verifique se eles correspondem ao que você vê na árvore do ZooKeeper:

    Roteador

    curl 0:8081/v1/servers/self/uuid

    Processador de mensagens

    curl 0:8082/v1/servers/self/uuid

    Agente do Qpid

    curl 0:8083/v1/servers/self/uuid

    Agente do Postgres

    curl 0:8084/v1/servers/self/uuid
  5. Use os dados de UUID para pesquisar a saída da árvore do ZooKeeper gerada na etapa 2 para validar a fiação dos componentes e remover registros duplicados do componente que tenha os UUIDs errados.
  6. Use as chamadas da API de gerenciamento listadas aqui para corrigir o registro do armazenamento de dados. Os componentes, como roteadores, processadores de mensagens, Postgres e Qpid se registram automaticamente no ZooKeeper durante o tempo de inicialização.

Resolução

Os problemas relacionados a dados do ZooKeeper precisam ser resolvidos caso a caso. Os dados no ZooKeeper são baseados nas topologias do Apigee Edge e variam de acordo com cada caso de uso. Se um dos sintomas do problema estiver ocorrendo, colete os dados conforme explicado na seção anterior e entre em contato com o suporte do Apigee Edge.