Mengaktifkan agregasi geografis dan peta geografis

Agregasi geografis memungkinkan Anda mengumpulkan data analisis untuk panggilan API berdasarkan lokasi geografis seperti region, benua, negara, dan kota. Dari data analisis ini, Anda dapat melihat GeoMap di UI Edge yang menunjukkan lokasi permintaan API:

Agregasi geografis berfungsi dengan mengekstrak data geografis dari database pihak ketiga dan menambahkan ke data analisis yang dikumpulkan oleh Edge. Informasi geografis dapat berisi kota, negara, benua, zona waktu, dan region permintaan yang dibuat ke proxy API.

Untuk menggunakan agregasi geografis, Anda harus membeli database Maxmind GeoIp2 yang berisi data ini informasi geografis. Lihat https://www.maxmind.com/en/geoip2-databases untuk informasi selengkapnya.

Mengaktifkan agregasi geografis

Secara default, agregasi geografis tidak diaktifkan. Untuk mengaktifkan agregasi geografis, Anda harus:

  • Pada semua server Qpid, instal {i>database MaxMind<i} dan konfigurasikan server Qpid untuk menggunakan anotasi.
  • Aktifkan tampilan Peta Geografis di UI Edge.

Menginstal MaxMind di semua server Edge Qpid

Gunakan prosedur berikut untuk menginstal database MaxMind di semua server Edge Qpid:

  1. Dapatkan database Maxmind GeoIp2.
  2. Buat folder berikut pada node server Qpid: 
    /opt/apigee/maxmind
  3. Download database Maxmind GeoIp2 ke /opt/apigee/maxmind.
  4. Ubah kepemilikan file database ke 'apigee' pengguna: 
    chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. Tetapkan izin di database ke 744: 
    chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. Tetapkan token berikut di /opt/apigee/customer/application/qpid-server.properties. Jika file tersebut tidak ada, buat file tersebut: 
    conf_ingestboot-service_vdim.geo.ingest.enabled=true
conf_ingestboot-service_vdim.geo.maxmind.db.path=/opt/apigee/maxmind/GeoIP2-City_20160127.mmdb

    Jika Anda menyimpan database Maxmind GeoIp2 di lokasi yang berbeda, edit properti jalur sebagaimana mestinya.

    Perhatikan bahwa file database ini berisi nomor versi. Jika nanti Anda menerima pemberitahuan {i>database <i}, mungkin ia memiliki nomor versi yang berbeda. Sebagai alternatif, buat {i>symlink<i} ke file database dan gunakan symlink di qpid-server.properties.

    Misalnya, buat symlink untuk "GeoIP2-City-current.mmdb" ke "GeoIP2-City_20160127.mmdb". Jika Anda nanti menerima {i>database<i} baru dengan nama file yang berbeda, Anda hanya perlu memperbarui {i>symlink<i} daripada harus mengkonfigurasi ulang dan memulai ulang server Qpid.

  7. Ubah kepemilikan file qpid-server.properties ke 'apigee' pengguna: 
    chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties
  8. Mulai ulang server Qpid: 
    /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart
  9. Ulangi proses ini pada setiap node Qpid.
  10. Untuk memvalidasi bahwa agregasi geografis berfungsi:
    1. Memicu beberapa panggilan proxy API pada proxy API contoh.
    2. Tunggu sekitar 5 - 10 menit sampai agregasi selesai.
    3. Buka konsol dan hubungkan ke server Postgres Edge: 
      psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee
    4. Lakukan kueri SELECT pada tabel analytics.agg_geo untuk menampilkan baris dengan atribut geografis: 
      select * from analytics.agg_geo;

      Anda akan melihat kolom berikut dalam hasil kueri yang diekstrak dari kueri Database GeoIp2 Maxmind: ax_geo_city, ax_geo_country, ax_geo_continent, ax_geo_timezone, ax_geo_region.

      Jika tabel agg_geo tidak terisi, periksa log server Qpid di /opt/apigee/var/log/edge-qpid-server/logs/ untuk mendeteksi potensi setiap pengecualian.

Mengaktifkan Peta Geografis di UI Edge

Gunakan prosedur berikut untuk mengaktifkan Peta Geografis di UI Edge:

  1. Tetapkan token berikut di /opt/apigee/customer/application/ui.properties untuk mengaktifkan Geo Maps. Jika file tersebut tidak ada, buat file tersebut: 
    conf_apigee_apigee.feature.disablegeomap=false
  2. Ubah kepemilikan file ui.properties ke 'apigee' pengguna: 
    chown apigee:apigee /opt/apigee/customer/application/ui.properties
  3. Mulai ulang UI Edge: 
    /opt/apigee/bin/apigee-service/bin/apigee-service edge-ui restart
  4. Di UI Edge, pilih Analytics > GeoMap untuk menampilkan agregasi geografis layanan otomatis dan data skalabel.

Memperbarui database MaxMind GeoIp2

MaxMind mengeluarkan pembaruan berkala untuk basis data Maxmind GeoIp2. Jika Anda menerima pemberitahuan gunakan prosedur berikut untuk menginstalnya di Edge:

  1. Dapatkan database Maxmind GeoIp2 yang telah diupdate.
  2. Download database Maxmind GeoIp2 ke /opt/apigee/maxmind.
  3. Periksa nama file database. Jika sama dengan file lama, seperti yang dijelaskan dalam /opt/apigee/customer/application/qpid-server.properties, lanjutkan ke langkah berikutnya. Tetapi, jika file tersebut memiliki nama yang berbeda, Anda harus mengedit qpid-server.properties untuk menentukan nama file database baru, lalu memulai ulang server Qpid, seperti yang dijelaskan di atas.

    Sebagai alternatif, Anda dapat membuat symlink ke file tersebut. Misalnya, buat {i>symlink<i} untuk "GeoIP2-City-current.mmdb" ke "GeoIP2-City_20160127.mmdb". Jika nanti Anda menerima database baru dengan nama file yang berbeda, Anda hanya perlu memperbarui symlink daripada harus mengkonfigurasi ulang server Qpid.

  4. Ubah kepemilikan file database ke 'apigee' pengguna: 
    chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. Tetapkan izin di database ke 744: 
    chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. Mulai ulang server Qpid: 
    /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart
  7. Ulangi proses ini pada setiap node Qpid.