مشاكل بيانات حارس حديقة الحيوان

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

المشكلة

يمكن أن تظهر المشاكل المتعلّقة بالبيانات، والتي يُشار إليها عادةً باسم مشاكل الربط، كأحد الأعراض التالية:

  • حالات تعذُّر أثناء بدء تشغيل خوادم الإدارة
  • حالات تعذُّر النشر
  • أخطاء Datastore في واجهة مستخدم Edge الجديدة
  • مشاكل إمكانية الاتصال بين مراكز البيانات المختلفة بين معالِجات الرسائل وخوادم الإدارة
  • عدم عرض أي بيانات في "إحصاءات Google"

لا تتعلّق هذه المشاكل ببنية 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، نفِّذ طلبات البيانات من واجهة برمجة التطبيقات الإدارية التالية للحصول على قائمة بمعرّفات 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:

    جهاز التوجيه

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

    معالِج الرسائل

    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. استخدِم بيانات المعرّف الفريد العالمي (UUID) للبحث في ناتج شجرة ZooKeeper الذي تم إنشاؤه في الخطوة 2 للتحقّق من صحة ربط المكوّنات وإزالة أي عمليات تسجيل مكرّرة للمكوّن الذي يحتوي على معرّفات فريدة عالمية غير صحيحة.
  6. استخدِم طلبات البيانات من Management API المدرَجة هنا لتصحيح تسجيل مخزن البيانات. تسجّل المكوّنات، مثل أجهزة التوجيه ومعالجات الرسائل وPostgres وQpid، نفسها في ZooKeeper أثناء وقت بدء التشغيل.

الدقة

ZooKeeper data-related problems need to be addressed on a case-by-case basis. تستند البيانات في ZooKeeper إلى طوبولوجيا Apigee Edge وتختلف حسب كل حالة استخدام. إذا واجهت أحد أعراض المشكلة، اجمَع البيانات كما هو موضّح في القسم السابق وتواصَل مع فريق دعم Apigee Edge.