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

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

لوحة بيانات GeoMap في واجهة مستخدم Edge الجديدة

تعمل عمليات التجميع الجغرافي من خلال استخراج البيانات الجغرافية من قاعدة بيانات تابعة لجهة خارجية وإضافة ذلك إلى بيانات "إحصاءات Google" التي يجمعها Edge. يمكن أن تحتوي المعلومات الجغرافية على المدينة، البلد والقارة والمنطقة الزمنية والمنطقة لطلب تم إرساله إلى خادم وكيل لواجهة برمجة التطبيقات.

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

تفعيل التجميع الجغرافي

لا يتم تفعيل عمليات التجميع الجغرافي تلقائيًا. لتفعيل عمليات التجميع الجغرافي، عليك إجراء ما يلي:

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

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

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

  1. احصل على قاعدة بيانات Maxmind GeoIp2.
  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

    إذا خزّنت قاعدة بيانات Maxmind GeoIp2 في موقع مختلف، عدِّل خاصية المسار وفقًا لذلك.

    يُرجى العِلم أنّ ملف قاعدة البيانات هذا يحتوي على رقم إصدار. إذا تلقّيت لاحقًا ملف قاعدة بيانات معدَّلاً ، قد يكون له رقم إصدار مختلف. كبديل، أنشئ رابطًا رمزيًا لـ ملف قاعدة البيانات واستخدِم الرابط الرمزي في 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/apigee-service/bin/apigee-service edge-qpid-server restart
  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 لعرض الصفوف التي تحتوي على سمات جغرافية: 
      select * from analytics.agg_geo;

      من المفترض أن تظهر لك الأعمدة التالية في نتائج الاستعلام التي يتم استخراجها من قاعدة بيانات Maxmind GeoIp2: ax_geo_city, ax_geo_country, ax_geo_continent, ax_geo_timezone, ax_geo_region.

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

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

اتّبِع الإجراء التالي لتفعيل "الخرائط الجغرافية" في واجهة مستخدِم New Edge:

  1. اضبط الرمز المميّز التالي في /opt/apigee/customer/application/management-ui.properties لتفعيل "الخرائط الجغرافية". إذا لم يكن هذا الملف موجودًا، أنشئه: 
    conf_uebe_disableGeoMap=false
  2. غيِّر ملكية ملف management-ui.properties إلى المستخدم apigee: 
    chown apigee:apigee /opt/apigee/customer/application/management-ui.properties
  3. أعِد تشغيل واجهة مستخدِم New Edge: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  4. في واجهة مستخدِم New Edge، انقر على تحليل > المستخدِمون النهائيون > الخريطة الجغرافية لعرض بيانات التجميع الجغرافي.

تعديل قاعدة بيانات 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/apigee-service/bin/apigee-service edge-qpid-server restart
  7. كرِّر هذه العملية على كل عقدة Qpid.