فعال کردن تجمیع جغرافیایی و نقشه‌های جغرافیایی

انبوهش جغرافیایی به شما امکان می‌دهد داده‌های تحلیلی را برای فراخوانی‌های میانای برنامه‌سازی کاربردی براساس ویژگی‌های جغرافیایی مانند منطقه، قاره، کشور، و شهر جمع‌آوری کنید. از این داده‌های تجزیه‌وتحلیل، می‌توانید GeoMap را در «میانای کاربری Edge» که مکان درخواست‌های API را نشان می‌دهد مشاهده کنید:

انبوهش‌های جغرافیایی با استخراج داده‌های جغرافیایی از پایگاه داده شخص ثالث و افزودن آن به داده‌های تحلیلی جمع‌آوری‌شده توسط 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. اجازه‌های پایگاه داده را روی ۷۴۴ تنظیم کنید:

   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. حدود ۵ تا ۱۰ دقیقه صبر کنید تا تجمیع‌ها تکمیل شود.
    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

از روش زیر برای فعال کردن Geo Maps در Edge UI استفاده کنید:

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 UI، Analytics > GeoMap را انتخاب کنید تا داده‌های تجمیع جغرافیایی نمایش داده شود.

درحال به‌روزرسانی پایگاه داده MaxMind GeoIp2

MaxMind به‌روزرسانی‌های دوره‌ای برای پایگاه داده Maxmind GeoIp2 منتشر می‌کند. اگر پایگاه داده به‌روزشده‌ای دریافت کردید، از روش زیر برای نصب آن در Edge استفاده کنید:

1. پایگاه داده GeoIp2 به‌روزشده Maxmind را دریافت کنید.
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. اجازه‌های پایگاه داده را روی ۷۴۴ تنظیم کنید:

   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 تکرار کنید.