Edge for Private Cloud v. 4.16.09
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:
- Maxmind GeoIp2 veritabanını edinin.
Not: Coğrafi toplama, Edge tarafından toplanan analiz verilerine üçüncü taraf veritabanından alınan coğrafi verilerin eklenmesiyle çalışır. Coğrafi toplamayı kullanmak için bu 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. - Qpid sunucu düğümünde aşağıdaki klasörü oluşturun:
/opt/apigee/maxmind - Maxmind GeoIp2 veritabanını /opt/apigee/maxmind adresine indirin.
- Veritabanı dosyasının sahipliğini 'Apigee' kullanıcısı olarak değiştirin:
> chown enhanced:Apigee /opt/Apigee/maxmind/GeoIP2-City_20160127.mmdb - Veritabanındaki izinleri 744 olarak ayarlayın:
> chmod 744 /opt/../..//maxmind/GeoIP2-City_20160127.mmdb - /opt/apigee/customer/application/qpid-server.properties adresinde aşağıdaki jetonları ayarlayın.
Bu dosya mevcut değilse oluşturun:
conf_ingestboot-service_vdim.geo.ingest.enabled=true
conf_ingestboot-service_vdim.geo.maxmind.db.path=/opt/impression/maxmind/GeoIP2-City_20160127.mmdbmind mülkünü farklı bir konumda depoluyorsanız
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şturun ve qpid-server.properties dosyasındaki 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. - qpid-server.properties dosyasının sahipliğini 'Apigee' adlı kullanıcı olarak değiştirin:
> chown become:Apigee /opt/impression/customer/application/qpid-server.properties - Qpid sunucusunu yeniden başlatın:
> /opt/Apigee/bin/Apigee-service/bin/Apigee-service kenar-qpid-server yeniden başlatma - Bu işlemi her Qpid düğümünde tekrarlayın.
- Coğrafi toplamanın çalıştığını doğrulamak için:
- Örnek bir API proxy'sinde birkaç API proxy çağrısı tetikleyin.
- Toplamaların tamamlanması için yaklaşık 5-10 dakika bekleyin.
- Bir konsol açın ve Edge Postgres sunucusuna bağlanın:
> psql -h /opt/impression/var/run/Apigee-postgresql/ -U Apigee -d Apigee - Coğrafi özelliklere sahip satırları göstermek için analytics.agg_geo tablosunda bir SELECT sorgusu gerçekleştirin:
Apigee=# select * from analytics.agg_geo;
Maxmind GeoIp2 veritabanından çıkarılan sorgu sonuçlarında şu sütunları görürsünüz: ax_geo_city, ax_geo_country, ax_geo_region_Continu
agg_geo tablosu doldurulmuyorsa olası istisnaları tespit etmek için /opt/../..//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:
- Coğrafi Haritalar'ı etkinleştirmek için /opt/apigee/customer/application/ui.properties dosyasında aşağıdaki jetonu ayarlayın. Bu dosya mevcut değilse oluşturun:
conf_apigee_apigee.feature.disablegeomap=false - ui.properties dosyasının sahipliğini 'Apigee' kullanıcısı olarak değiştirin:
> chown Apigee:Apigee /opt/Apigee/customer/application/ui.properties - Edge kullanıcı arayüzünü yeniden başlatın:
> /opt/Apigee/bin/Apigee-service/bin/Apigee-service kenar-ui yeniden başlatma - 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:
- Güncellenmiş Maxmind GeoIp2 veritabanını edinin.
- Maxmind GeoIp2 veritabanını /opt/apigee/maxmind adresine indirin.
- Veritabanı dosyasının adını kontrol edin. /opt/apigee/customer/application/qpid-server.properties adresinde 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, ardından yukarıda açıklandığı gibi Qpid sunucusunu yeniden başlatmanız gerekir.
Alternatif olarak, dosyaya yönelik bir sembolik 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. - Veritabanı dosyasının sahipliğini 'Apigee' kullanıcısı olarak değiştirin:
> chown enhanced:Apigee /opt/Apigee/maxmind/GeoIP2-City_20160127.mmdb - Veritabanındaki izinleri 744 olarak ayarlayın:
> chmod 744 /opt/../..//maxmind/GeoIP2-City_20160127.mmdb - Qpid sunucusunu yeniden başlatın:
> /opt/Apigee/bin/Apigee-service/bin/Apigee-service kenar-qpid-server yeniden başlatma - Bu işlemi her Qpid düğümünde tekrarlayın.