تفعيل التجميع الجغرافي و"خرائط Google"

الإصدار 4.18.01 من Edge الخاص بخدمة Private Cloud

تتيح لك تجميعات المواقع الجغرافية جمع بيانات الإحصاءات عن طلبات البيانات من واجهة برمجة التطبيقات استنادًا إلى سمات جغرافية، مثل المنطقة والقارة والبلد والمدينة. ومن خلال هذه البيانات الإحصائية، يمكنك عرض خريطة جغرافية في واجهة مستخدم Edge تعرض الموقع الجغرافي لطلبات واجهة برمجة التطبيقات:

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

لاستخدام ميزة تجميع المواقع الجغرافية، يجب شراء قاعدة بيانات Maxmind GeoIp2 التي تحتوي على هذه المعلومات الجغرافية. يمكنك الاطّلاع على https://www.maxmind.com/en/geoip2-databases للحصول على مزيد من المعلومات.

تفعيل تجميع المواقع الجغرافية

وتكون عمليات تجميع المواقع الجغرافية غير مُفعَّلة بشكلٍ تلقائي. لتفعيل تجميعات المواقع الجغرافية، يجب:

  • على جميع خوادم Qpid، ثبِّت قاعدة بيانات MaxMind واضبط خادم Qpid لاستخدامه.
  • تفعيل عرض الخريطة الجغرافية في واجهة مستخدم Edge.

تثبيت قاعدة بيانات MaxMind على جميع خوادم Edge Qpid

استخدم الإجراء التالي لتثبيت قاعدة بيانات MaxMind على جميع خوادم Edge Qpid:

  1. احصل على قاعدة بيانات Maxmind GeoIp2.
    ملاحظة: تعمل مجموعات المواقع الجغرافية عن طريق إضافة بيانات جغرافية من قاعدة بيانات تابعة لجهة خارجية إلى بيانات الإحصاءات التي تجمعها شركة Edge. لاستخدام التجميع الجغرافي، عليك شراء قاعدة بيانات Maxmind GeoIp2 التي تحتوي على هذه المعلومات. يمكنك الانتقال إلى https://www.maxmind.com/en/geoip2-databases للحصول على مزيد من المعلومات.
  2. أنشئ المجلد التالي على عقدة خادم Qpid:
    /opt/apigee/maxmind
  3. نزِّل قاعدة بيانات Maxmind GeoIp2 إلى /opt/apigee/maxmind.
  4. غيِّر ملكية ملف قاعدة البيانات إلى مستخدم "apigee":
    > chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. اضبط الأذونات في قاعدة البيانات على 744:
    > chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. اضبط الرموز المميّزة التالية في /opt/apigee/customer/application/qpid-server.properties. إذا لم يكن هذا الملف موجودًا، يمكنك إنشاؤه:
    conf_ingestboot-service_vdim.geo.ingest.enabled=true
    conf_ingestboot-service_vdim.geo.maxmind.db.path=/opt/apigee/maxmind/GeoIP2-City_20160127.mmdb


    لاحظ أن ملف قاعدة البيانات هذا يحتوي على رقم إصدار. إذا تلقيت لاحقًا ملف قاعدة بيانات محدّثًا، قد يكون له رقم إصدار مختلف. وكبديل لهذا الإجراء، يمكنك إنشاء رابط رمزي لملف قاعدة البيانات واستخدام الرابط الرمزي في qpid-server.properties.

    على سبيل المثال، يمكنك إنشاء رابط رمزي لـ "GeoIP2-City-current.mmdb" إلى "GeoIP2-City_20160127.mmdb". إذا تلقيت لاحقًا قاعدة بيانات جديدة باسم ملف مختلف، لن يلزمك سوى تعديل الرابط الرمزي بدلاً من الحاجة إلى إعادة ضبط خادم Qpid وإعادة تشغيله.
  7. غيِّر ملكية الملف qpid-server.properties إلى مستخدِم "apigee":
    > chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties
  8. أعِد تشغيل خادم Qpid:
    > /opt/apigee/bin/apigee-service/bin/apigee-service Edge-qpid-server إعادة تشغيل
  9. كرر هذه العملية على كل عقدة Qpid.
  10. للتأكّد من عمل تجميع المواقع الجغرافية بشكلٍ سليم:
    1. يؤدي هذا الإجراء إلى تشغيل العديد من طلبات الخادم الوكيل لواجهة برمجة التطبيقات على نموذج خادم وكيل لواجهة برمجة التطبيقات.
    2. انتظر حوالي 5 - 10 دقائق حتى تكتمل المجموعات.
    3. افتح وحدة تحكُّم واتصِل بخادم Edge Postgres:
      > psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee
    4. نفِّذ طلب بحث SELECT في الجدول analytics.agg_geo لعرض الصفوف ذات السمات الجغرافية:
      apigee=# select * from analytics.agg_geo;

      من المفترض أن تظهر لك الأعمدة التالية في نتائج طلب البحث المستخرجة من قاعدة بيانات Maxmind GeoIp2: ax_geo_city, ax_zone,geo_country, ax_region.geo_continent_

      إذا لم تتم تعبئة الجدول agg_geo، راجِع سجلات خادم Qpid على /opt/apigee/var/log/edge-qpid-server/logs/ لرصد أي استثناءات محتملة.

تفعيل الخرائط الجغرافية في واجهة مستخدم Edge

استخدم الإجراء التالي لتمكين الخرائط الجغرافية في واجهة مستخدم Edge:

  1. اضبط الرمز المميّز التالي في /opt/apigee/customer/application/ui.properties لتفعيل "خرائط المواقع الجغرافية". إذا لم يكن الملف متوفّرًا، يمكنك إنشاؤه:
    conf_apigee_apigee.feature.disablegeomap=false
  2. غيِّر ملكية ملف ui.properties لمستخدم "apigee":
    > chown apigee:apigee /opt/apigee/customer/application/ui.properties
  3. أعِد تشغيل واجهة مستخدم Edge:
    > /opt/apigee/bin/apigee-service/bin/apigee-service Edge-ui redirect
  4. في واجهة مستخدم Edge، اختَر إحصاءات Google > خريطة الموقع الجغرافي لعرض بيانات تجميع المواقع الجغرافية.

تحديث قاعدة بيانات MaxMind GeoIp2

تُصدر MaxMind تحديثات دورية لقاعدة بيانات Maxmind GeoIp2. إذا تلقيت قاعدة بيانات محدثة، فاستخدم الإجراء التالي لتثبيتها على Edge:

  1. الحصول على قاعدة بيانات Maxmind GeoIp2 المُحدَّثة.
  2. نزِّل قاعدة بيانات Maxmind GeoIp2 إلى /opt/apigee/maxmind.
  3. تحقق من اسم ملف قاعدة البيانات. إذا كان الملف مماثلاً للملف القديم، على النحو المحدّد في ?/opt/apigee/customer/application/qpid-server.properties، انتقِل إلى الخطوة التالية. أما إذا كان للملف اسمًا مختلفًا، فيجب تعديل ملف qpid-server.properties لتحديد اسم ملف قاعدة البيانات الجديد ثم إعادة تشغيل خادم Qpid، كما هو موضّح أعلاه.

    كبديل، يمكنك إنشاء رابط رمزي للملف. على سبيل المثال، يمكنك إنشاء رابط رمزي لـ "GeoIP2-City-current.mmdb" إلى "GeoIP2-City_20160127.mmdb". إذا تلقيت لاحقًا قاعدة بيانات جديدة باسم ملف مختلف، لن تحتاج سوى إلى تعديل الرابط الرمزي بدلاً من الحاجة إلى إعادة ضبط خادم Qpid.
  4. غيِّر ملكية ملف قاعدة البيانات إلى مستخدم "apigee":
    > chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. اضبط الأذونات في قاعدة البيانات على 744:
    > chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. أعِد تشغيل خادم Qpid:
    > /opt/apigee/bin/apigee-service/bin/apigee-service Edge-qpid-server إعادة تشغيل
  7. كرر هذه العملية على كل عقدة Qpid.