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

تتيح لك عمليات التجميع الجغرافي جمع بيانات الإحصاءات لطلبات البيانات من واجهة برمجة التطبيقات استنادًا إلى السمات الجغرافية، مثل المنطقة والقارة والبلد والمدينة. من بيانات الإحصاءات هذه، يمكنك عرض خريطة جغرافية في واجهة مستخدم 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، اختَر الإحصاءات > GeoMap لعرض بيانات التجميع الجغرافي.

تعديل قاعدة بيانات 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.