Coğrafi toplamayı ve coğrafi haritaları etkinleştirme

Coğrafi toplamalar, bölge, kıta, ülke ve şehir gibi coğrafi özelliklere göre API çağrıları için analiz verileri toplamanıza olanak tanır. Bu analiz verilerinden, Yeni Edge kullanıcı arayüzünde API isteklerinin konumunu gösteren bir Coğrafi Harita görüntüleyebilirsiniz:

Coğrafi toplama, üçüncü taraf veritabanından coğrafi verileri ayıklayıp Edge tarafından toplanan analiz verilerine ekleyerek çalışır. Coğrafi bilgiler, bir API proxy'sine yapılan isteğin şehri, ülkesi, kıtası, saat dilimi ve bölgesini içerebilir.

Coğrafi birleştirmeyi kullanmak için bu coğrafi bilgileri içeren Maxmind GeoIp2 veritabanını satın almanız gerekir. Daha fazla bilgi için https://www.maxmind.com/en/geoip2-databases adresini ziyaret edin.

Coğrafi birleştirmeyi etkinleştirme

Coğrafi toplamalar varsayılan olarak etkin değildir. Coğrafi toplamaları etkinleştirmek için:

• Tüm Qpid sunucularına MaxMind veritabanını yükleyin ve Qpid sunucusunu bu veritabanını kullanacak şekilde yapılandırın.
• Yeni Edge kullanıcı arayüzünde coğrafi harita görünümünü etkinleştirin.

MaxMind veritabanını tüm Edge Qpid sunucularına yükleme

MaxMind veritabanını tüm Edge Qpid sunucularına yüklemek için aşağıdaki prosedürü kullanın:

1. Maxmind GeoIp2 veritabanını edinin.
   
2. Qpid sunucu düğümünde aşağıdaki klasörü oluşturun:

   /opt/apigee/maxmind

3. Maxmind GeoIp2 veritabanını /opt/apigee/maxmind konumuna indirin.
4. Veritabanı dosyasının sahipliğini "apigee" kullanıcısı olarak değiştirin:

   chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb

5. Veritabanındaki izinleri 744 olarak ayarlayın:

   chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb

6. /opt/apigee/customer/application/qpid-server.properties içinde aşağıdaki jetonları ayarlayın. Bu dosya yoksa oluşturun:

   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 veritabanını farklı bir konumda sakladıysanız yol özelliğini buna göre düzenleyin.

   Bu veritabanı dosyasının sürüm numarası içerdiğini unutmayın. Daha sonra güncellenmiş bir veritabanı dosyası alırsanız bu dosyanın sürüm numarası farklı olabilir. Alternatif olarak, veritabanı dosyasına bir sembolik bağlantı oluşturun ve qpid-server.properties içinde sembolik bağlantıyı kullanın.

   Örneğin, "GeoIP2-City-current.mmdb" için "GeoIP2-City_20160127.mmdb"ye bir sembolik bağlantı oluşturun. Daha sonra farklı bir dosya adına sahip yeni bir veritabanı alırsanız Qpid sunucusunu yeniden yapılandırmanız ve yeniden başlatmanız gerekmez. Yalnızca sembolik bağlantıyı güncellemeniz yeterlidir.

7. qpid-server.properties dosyasının sahipliğini "apigee" kullanıcısına değiştirin:

   chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties

8. Qpid sunucusunu yeniden başlatın:

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart

9. Bu işlemi her Qpid düğümünde tekrarlayın.
10. Coğrafi toplamanın çalıştığını doğrulamak için:
    1. Örnek bir API proxy'sinde birkaç API proxy çağrısı tetikleme
    2. Toplama işlemlerinin tamamlanması için yaklaşık 5-10 dakika bekleyin.
    3. Bir konsol açın ve Edge Postgres sunucusuna bağlanın:

       psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee

    4. Coğrafi özelliklere sahip satırları göstermek için analytics.agg_geo tablosunda bir SELECT sorgusu gerçekleştirin:

       select * from analytics.agg_geo;

       Maxmind GeoIp2 veritabanından çıkarılan sorgu sonuçlarında aşağıdaki sütunları görmeniz gerekir: ax_geo_city, ax_geo_country, ax_geo_continent, ax_geo_timezone, ax_geo_region.

       agg_geo tablosu doldurulmuyorsa olası istisnaları tespit etmek için /opt/apigee/var/log/edge-qpid-server/logs/ adresindeki Qpid sunucu günlüklerini kontrol edin.

Yeni Edge kullanıcı arayüzünde coğrafi haritaları etkinleştirme

Yeni Edge kullanıcı arayüzünde Coğrafi Haritalar'ı etkinleştirmek için aşağıdaki prosedürü kullanın:

1. Coğrafi haritaları etkinleştirmek için /opt/apigee/customer/application/management-ui.properties dosyasında aşağıdaki jetonu ayarlayın. Bu dosya yoksa oluşturun:

   conf_uebe_disableGeoMap=false

2. management-ui.properties dosyasının sahipliğini apigee kullanıcısına aktarın:

   chown apigee:apigee /opt/apigee/customer/application/management-ui.properties

3. Yeni Edge kullanıcı arayüzünü yeniden başlatma:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

4. Yeni Edge kullanıcı arayüzünde, coğrafi toplama verilerini görüntülemek için Analyze > End Users > Geomap'i (Analiz > Son Kullanıcılar > Coğrafi Harita) seçin.

MaxMind GeoIp2 veritabanını güncelleme

MaxMind, Maxmind GeoIp2 veritabanında düzenli olarak güncellemeler yayınlar. Güncellenmiş bir veritabanı alırsanız Edge'e yüklemek için aşağıdaki prosedürü kullanın:

1. Güncellenen Maxmind GeoIp2 veritabanını edinin.
2. Maxmind GeoIp2 veritabanını /opt/apigee/maxmind konumuna indirin.
3. Veritabanı dosyasının adını kontrol edin. /opt/apigee/customer/application/qpid-server.properties bölümünde tanımlandığı gibi eski dosyayla aynıysa sonraki adıma geçin. Ancak dosyanın adı farklıysa yeni veritabanı dosyasının adını belirtmek için qpid-server.properties dosyasını düzenlemeniz ve yukarıda açıklandığı gibi Qpid sunucusunu yeniden başlatmanız gerekir.

   Alternatif olarak, dosyaya sembolik bağlantı oluşturabilirsiniz. Örneğin, "GeoIP2-City-current.mmdb" için "GeoIP2-City_20160127.mmdb" adlı bir sembolik bağlantı oluşturun. Daha sonra farklı bir dosya adına sahip yeni bir veritabanı alırsanız Qpid sunucusunu yeniden yapılandırmak yerine yalnızca sembolik bağlantıyı güncellemeniz gerekir.

4. Veritabanı dosyasının sahipliğini "apigee" kullanıcısına değiştirin:

   chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb

5. Veritabanındaki izinleri 744 olarak ayarlayın:

   chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb

6. Qpid sunucusunu yeniden başlatın:

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart

7. Bu işlemi her Qpid düğümünde tekrarlayın.