Problemas con los datos de Zookeeper

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X.
info

Síntoma

Los problemas relacionados con los datos, que suelen denominarse problemas de cableado, pueden manifestarse como uno de los siguientes síntomas:

  • Errores durante el inicio de los servidores de administración
  • Errores de implementación
  • Errores de Datastore en la IU
  • Problemas de conectividad entre centros de datos entre Message Processors y servidores de administración
  • Analytics no muestra datos

Estos problemas no están relacionados con la infraestructura de ZooKeeper, sino con datos no válidos que están disponibles en el árbol de ZooKeeper.

Causas posibles

Las causas típicas de este problema son las siguientes:

  1. Nodos conectados a la región o al nombre de pod incorrectos durante la instalación debido a errores en el archivo de instalación silenciosa
  2. Una instalación fallida de un componente crea registros duplicados cuando vuelves a instalar el componente varias veces. En este caso, se requiere una limpieza para quitar el registro con los UUID incorrectos.

Diagnóstico

Para realizar un diagnóstico, recopila los siguientes datos:

  1. Diagrama de topología, con el nombre de host y las direcciones IP de cada nodo, y qué componente de Apigee existe en el nodo Sería más útil un mapeo como el siguiente con el perfil de la instalación de Apigee:
    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. Genera el resultado del árbol de ZooKeeper para verificar el cableado:
    /opt/apigee/apigee-zookeeper/contrib/zk-tree.sh > zk-tree-output.txt
  3. Para facilitar la verificación de los datos en el árbol de ZooKeeper, ejecuta las siguientes llamadas a la API de administración para obtener la lista de UUID del servidor en cada uno de los centros de datos:

    Servidores de puerta de enlace

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

    Servidores centrales

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

    Servidores de Analytics

    curl -u sysadmin@email.com "http://management-server-host:8080/v1/servers?pod=analytics&region=region-name"
  4. Verifica los UUID en cada componente y asegúrate de que coincidan con lo que ves en el árbol de ZooKeeper tree:

    Router

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

    Message Processor

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

    Agente de Qpid

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

    Agente de Postgres

    curl 0:8084/v1/servers/self/uuid
  5. Usa los datos de UUID para buscar el resultado del árbol de ZooKeeper generado en el paso 2 para validar el cableado de los componentes y quitar cualquier registro duplicado del componente que tenga los UUID incorrectos.
  6. Usa las llamadas a la API de administración que se enumeran aquí para corregir el registro de Datastore. Los componentes como Routers, Message Processors, Postgres y Qpid se registran automáticamente en ZooKeeper durante el tiempo de inicio.

Solución

Los problemas relacionados con los datos de ZooKeeper deben abordarse caso por caso. Los datos de ZooKeeper se basan en las topologías de Apigee Edge y varían según cada caso de uso. Si experimentas uno de los síntomas del problema, recopila los datos como se explica en la sección anterior y comunícate con la Asistencia de Apigee Edge.