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

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

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

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

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

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

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

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

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

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/bin/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/ لرصد أي استثناءات محتملة.

تفعيل الخرائط الجغرافية في واجهة مستخدم 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 restart

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 restart

7. كرر هذه العملية على كل عقدة Qpid.