Zookeeper 데이터 문제

Apigee Edge 문서를 보고 있습니다.
Go to the Apigee X 문서로 이동합니다. info

증상

일반적으로 연결 문제라고 하는 데이터 관련 문제는 다음 증상 중 하나로 나타날 수 있습니다.

  • 관리 서버 시작 중 오류
  • 배포 실패
  • UI의 데이터 저장소 오류
  • 메시지 프로세서와 관리 서버 간의 데이터 센터 간 연결 문제
  • 애널리틱스에 데이터가 표시되지 않음

이러한 문제는 ZooKeeper 인프라와 관련이 없지만 ZooKeeper 트리에 있는 잘못된 데이터와 관련이 있습니다.

가능한 원인

이 문제의 일반적인 원인은 다음과 같습니다.

  1. 자동 설치 파일의 실수로 인해 설치 중에 잘못된 리전 또는 포드 이름에 연결된 노드
  2. 구성요소 설치가 실패하면 구성요소를 여러 번 다시 설치할 때 중복 등록이 생성됩니다. 이 경우 잘못된 UUID로 등록을 삭제하려면 정리해야 합니다.

진단

진단하려면 다음 데이터를 수집하세요.

  1. 각 노드의 호스트 이름과 IP 주소, 노드에 있는 Apigee 구성요소 가 포함된 토폴로지 다이어그램 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. ZooKeeper 트리 출력을 생성하여 연결을 확인합니다. 
    /opt/apigee/apigee-zookeeper/contrib/zk-tree.sh > zk-tree-output.txt
  3. ZooKeeper 트리의 데이터를 쉽게 확인할 수 있도록 다음 관리 API 호출을 실행하여 각 데이터 센터의 서버 UUID 목록을 가져옵니다.

    게이트웨이 서버

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

    중앙 서버

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

    애널리틱스 서버

    curl -u sysadmin@email.com "http://management-server-host:8080/v1/servers?pod=analytics&region=region-name"
  4. 각 구성요소의 UUID를 확인하고 ZooKeeper 트리에 표시되는 UUID와 일치하는지 확인합니다.

    라우터

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

    메시지 프로세서

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

    Qpid 에이전트

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

    Postgres 에이전트

    curl 0:8084/v1/servers/self/uuid
  5. UUID 데이터를 사용하여 2단계에서 생성된 ZooKeeper 트리 출력을 검색하여 구성요소 연결을 확인하고 잘못된 UUID가 있는 구성요소의 중복 등록을 삭제합니다.
  6. 데이터 저장소 등록을 수정하려면 여기에 나열된 관리 API 호출을 사용하세요. 라우터, 메시지 프로세서, Postgres, Qpid와 같은 구성요소는 시작 시 ZooKeeper에 자체 등록됩니다.

해상도

ZooKeeper 데이터 관련 문제는 사례별로 해결해야 합니다. ZooKeeper의 데이터는 Apigee Edge 토폴로지를 기반으로 하며 각 사용 사례에 따라 다릅니다. 문제 증상 중 하나가 발생하면 이전 섹션에 설명된 대로 데이터를 수집하고 Apigee Edge 지원팀에 문의하세요.