Problemas de dados do Zookeeper

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X
.info

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 de implantação
  • Erros de repositório de dados na interface
  • Problemas de conectividade entre data centers entre processadores de mensagens e servidores de gerenciamento
  • O Google Analytics não mostra dados

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

Causas possíveis

As causas típicas desse problema são:

  1. Nós conectados à região ou nome de 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 você reinstala o componente várias vezes. Nesse caso, é necessário limpar para remover o registro com os UUIDs errados.

Diagnóstico

Para diagnosticar, colete os seguintes dados:

  1. Diagrama de topologia, com nome do host e endereços IP 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 Management para receber a lista de UUIDs do servidor em cada data center:

    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 em cada componente e confira se eles correspondem ao que você vê na árvore do ZooKeeper tree:

    Roteador

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

    Processador de mensagens

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

    Agente 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 têm os UUIDs errados.
  6. Use as chamadas da API Management listadas aqui para corrigir o registro do repositório de dados. Os componentes, como roteadores, processadores de mensagens , Postgres e Qpid, se registram automaticamente no ZooKeeper durante a inicialização.

Resolução

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