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, Edge kullanıcı arayüzünde API isteklerinin konumunu gösteren bir coğrafi harita görüntüleyebilirsiniz:

Coğrafi toplama işlemleri, coğrafi verileri üçüncü taraf veritabanından çıkarıp Edge tarafından toplanan analiz verilerine ekleyerek çalışır. Coğrafi bilgiler; API proxy'sine yapılan bir isteğin şehir, ülke, kıta, saat dilimi ve bölgesini içerebilir.

Coğrafi toplamayı 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 adresine bakın.

Coğrafi toplamayı 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 bunu kullanacak şekilde yapılandırın.
  • 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 hedefine 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 ürününde aşağıdaki jetonları ayarlayın. 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 depoladıysanız yol özelliğini buna göre düzenleyin.

    Bu veritabanı dosyasının bir 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ı için bir sembolik bağlantı oluşturup qpid-server.properties içindeki sembolik bağlantıyı kullanın.

    Örneğin, "GeoIP2-City-current.mmdb" için "GeoIP2-City_20160127.mmdb" olarak 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ırıp yeniden başlatmak yerine sembolik bağlantıyı güncellemeniz yeterlidir.

  7. qpid-server.properties dosyasının sahipliğini 'Apigee' kullanıcısı olarak değiştirin: 
    chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties
  8. Qpid sunucusunu yeniden başlatın: 
    /opt/apigee/bin/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ı tetikleyin.
    2. Toplamaların 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 şu 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.

Edge kullanıcı arayüzünde Coğrafi Haritalar'ı etkinleştirme

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/ui.properties içinde aşağıdaki jetonu ayarlayın. Dosya yoksa oluşturun: 
    conf_apigee_apigee.feature.disablegeomap=false
  2. ui.properties dosyasının sahipliğini 'Apigee' kullanıcısıyla değiştirin: 
    chown apigee:apigee /opt/apigee/customer/application/ui.properties
  3. Edge kullanıcı arayüzünü yeniden başlatın: 
    /opt/apigee/bin/apigee-service/bin/apigee-service edge-ui restart
  4. Coğrafi toplama verilerini görüntülemek için Edge kullanıcı arayüzünde Analytics > Coğrafi Harita'yı seçin.

MaxMind GeoIp2 veritabanını güncelleme

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

  1. Güncellenmiş Maxmind GeoIp2 veritabanını edinin.
  2. Maxmind GeoIp2 veritabanını /opt/apigee/maxmind hedefine indirin.
  3. Veritabanı dosyasının adını kontrol edin. Bu dosya, /opt/apigee/customer/application/qpid-server.properties politikasında tanımlandığı şekilde 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 ardından Qpid sunucusunu yukarıda açıklandığı gibi yeniden başlatmanız gerekir.

    Alternatif olarak, dosya için sembolik bir bağlantı oluşturabilirsiniz. Örneğin, "GeoIP2-City-current.mmdb" için "GeoIP2-City_20160127.mmdb" olarak 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 sembolik bağlantıyı güncellemeniz yeterli olur.

  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. Qpid sunucusunu yeniden başlatın: 
    /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart
  7. Bu işlemi her Qpid düğümünde tekrarlayın.