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

الإصدار 4.18.01 من Edge for 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

    إذا خزّنت قاعدة بيانات 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 لعرض الصفوف التي تتضمّن سمات جغرافية:
      apigee=# 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، اختَر الإحصاءات > الخريطة الجغرافية لعرض بيانات التجميع الجغرافي.

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