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

انبوهش جغرافیایی به شما امکان می‌دهد داده‌های تحلیلی را برای فراخوانی‌های میانای برنامه‌سازی کاربردی براساس ویژگی‌های جغرافیایی مانند منطقه، قاره، کشور، و شهر جمع‌آوری کنید. از این داده‌های Analytics می‌توانید GeoMap را در «میانای کاربری New 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/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 جدید

از روش زیر برای فعال کردن «نقشه‌های جغرافیایی» در «واسط کاربر 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. در «میانای کاربری Edge جدید»، تجزیه‌وتحلیل > کاربران نهایی > نقشه جغرافیایی را انتخاب کنید تا داده‌های تجمیع جغرافیایی نمایش داده شود.

درحال به‌روزرسانی پایگاه داده 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/apigee-service/bin/apigee-service edge-qpid-server restart

7. این فرایند را در هر گره Qpid تکرار کنید.