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

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X.
المعلومات

المشكلة

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

  • حالات الإخفاق أثناء بدء تشغيل خوادم الإدارة
  • حالات تعذُّر النشر
  • أخطاء مخزن البيانات على واجهة المستخدم
  • مشكلات الاتصال بمركز البيانات بين معالجات الرسائل وخوادم الإدارة
  • عدم ظهور أي بيانات في "إحصاءات 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"
    

    خوادم "إحصاءات Google"

    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

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

    وكيل Postgres

    curl 0:8084/v1/servers/self/uuid
    
  5. استخدِم بيانات UUID للبحث في نتائج شجرة ZooKeeper التي تم إنشاؤها في الخطوة رقم 2 للتحقق من صحة توصيل أسلاك المكوّنات وإزالة أي تسجيلات مكررة للمكوِّن الذي يحتوي على UUID غير صحيح.
  6. استخدِم طلبات البيانات من واجهة برمجة التطبيقات للإدارة المدرَجة هنا لتصحيح التسجيل في مخزن البيانات. يتم تسجيل مكونات مثل أجهزة التوجيه ومعالجات الرسائل وPostgres وQpid في ZooKeeper أثناء وقت بدء التشغيل.

درجة الدقّة

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