Masalah Data Zookeeper

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X.
info

Gejala

Masalah terkait data, yang umumnya disebut sebagai masalah kabel, dapat muncul sebagai salah satu gejala berikut:

  • Kegagalan selama startup server Pengelolaan
  • Kegagalan deployment
  • Error Datastore di UI
  • Masalah konektivitas lintas pusat data di antara server Pengelola Pesan dan server Pengelolaan
  • Analytics tidak menampilkan data

Masalah ini tidak terkait dengan infrastruktur ZooKeeper, tetapi terkait dengan data tidak valid yang tersedia di struktur ZooKeeper.

Kemungkinan penyebab

Penyebab umum masalah ini adalah:

  1. Node yang terhubung ke nama region atau pod yang salah selama penginstalan karena kesalahan dalam file penginstalan senyap.
  2. Penginstalan komponen yang gagal akan membuat pendaftaran duplikat saat Anda menginstal ulang komponen beberapa kali. Dalam hal ini, pembersihan diperlukan untuk menghapus pendaftaran dengan UUID yang salah.

Diagnosis

Untuk mendiagnosis, kumpulkan data berikut:

  1. Diagram topologi, dengan nama host dan alamat IP setiap node serta komponen Apigee yang ada di node. Pemetaan seperti berikut menggunakan profil penginstalan Apigee akan sangat membantu:
    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. Buat output hierarki ZooKeeper untuk memeriksa jaringan kabel:
    /opt/apigee/apigee-zookeeper/contrib/zk-tree.sh > zk-tree-output.txt
  3. Untuk memudahkan verifikasi data di hierarki ZooKeeper, jalankan panggilan API pengelolaan berikut untuk mendapatkan daftar UUID server di setiap pusat data:

    Gateway Servers

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

    Server Pusat

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

    Server Analytics

    curl -u sysadmin@email.com "http://management-server-host:8080/v1/servers?pod=analytics&region=region-name"
  4. Periksa UUID di setiap komponen dan pastikan UUID tersebut cocok dengan yang Anda lihat di struktur ZooKeeper:

    Router

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

    Message Processor

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

    Qpid Agent

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

    Postgres Agent

    curl 0:8084/v1/servers/self/uuid
  5. Gunakan data UUID untuk menelusuri output struktur ZooKeeper yang dihasilkan pada langkah #2 untuk memvalidasi pengkabelan komponen dan menghapus pendaftaran duplikat untuk komponen yang memiliki UUID yang salah.
  6. Gunakan panggilan API pengelolaan yang tercantum di sini untuk memperbaiki pendaftaran datastore. Komponen seperti Router, Pemroses Pesan, Postgres, dan Qpid mendaftar sendiri ke ZooKeeper selama waktu startup.

Resolusi

Masalah terkait data ZooKeeper harus ditangani berdasarkan kasus per kasus. Data di ZooKeeper didasarkan pada topologi Apigee Edge dan bervariasi menurut setiap kasus penggunaan. Jika salah satu gejala masalah dialami, kumpulkan data seperti yang dijelaskan di bagian sebelumnya dan hubungi Dukungan Apigee Edge.