Zookeeper 데이터 문제

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동
정보

증상

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

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

이 문제는 주Keeper 인프라와는 관련이 없고, 주Keeper 트리에서 사용할 수 있는 잘못된 데이터와 관련이 있습니다.

가능한 원인

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

  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. JoKeeper 트리 출력을 생성하여 배선을 확인합니다.
    /opt/apigee/apigee-zookeeper/contrib/zk-tree.sh > zk-tree-output.txt
    
  3. 주Keeper 트리의 데이터를 쉽게 확인하려면 다음 관리 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를 확인하고 JoKeeper 트리에 표시되는 것과 일치하는지 확인합니다.

    라우터

    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단계에서 생성된 JoKeeper 트리 출력을 검색하여 구성요소 배선을 검증하고 UUID가 잘못된 구성요소의 중복 등록을 삭제합니다.
  6. 데이터 저장소 등록을 수정하려면 여기에 나열된 관리 API 호출을 사용하세요. 라우터, 메시지 프로세서, Postgres, Qpid와 같은 구성요소는 시작 시간 동안 주Keeper에 자체 등록됩니다.

해상도

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