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

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

المشكلة

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

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

لا ترتبط هذه المشاكل ببنية ZooKeeper الأساسية، بل ترتبط ببيانات غير صالحة متوفّرة في شجرة ZooKeeper.

الأسباب المحتملة

تشمل الأسباب الشائعة لهذه المشكلة ما يلي:

  1. عُقد تم ربطها بمنطقة أو اسم مجموعة غير صحيحَين أثناء التثبيت بسبب أخطاء في ملف التثبيت التلقائي.
  2. يؤدي تعذُّر تثبيت أحد المكوّنات إلى إنشاء عمليات تسجيل مكرّرة عند إعادة تثبيت المكوّن عدة مرات. في هذه الحالة، يجب إجراء عملية تنظيف لإزالة التسجيل باستخدام المعرّفات الفريدة الشاملة غير الصحيحة.

التشخيص

لتحديد المشكلة، اجمع البيانات التالية:

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

الدقة

يجب معالجة المشاكل المتعلّقة ببيانات ZooKeeper بشكل فردي. تستند البيانات في ZooKeeper إلى طُرق عرض Apigee Edge وتختلف حسب كل حالة استخدام. في حال ظهور إحدى أعراض المشكلة، اجمع البيانات كما هو موضّح في القسم السابق وتواصَل مع فريق دعم Apigee Edge.