Mengaktifkan agregasi geografis dan peta geografis

Agregasi geografis memungkinkan Anda mengumpulkan data analisis untuk panggilan API berdasarkan atribut geografis seperti wilayah, 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 menambahkannya ke data analisis yang dikumpulkan oleh Edge. Informasi geografis dapat berisi kota, negara, benua, zona waktu, dan wilayah permintaan yang diajukan ke proxy API.

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

Mengaktifkan agregasi geografis

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

  • Di semua server Qpid, instal database MaxMind dan konfigurasikan server Qpid untuk menggunakannya.
  • Mengaktifkan tampilan Peta Geografis di UI Edge.

Instal database MaxMind di semua server Edge Qpid

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

  1. Dapatkan {i>database<i} 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 pengguna 'apigee':
    chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. Tetapkan izin pada 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 lain, edit properti jalur sebagaimana mestinya.

    Perhatikan bahwa file database ini berisi nomor versi. Jika nantinya Anda menerima file database yang telah diperbarui, file tersebut mungkin memiliki nomor versi yang berbeda. Sebagai alternatif, buat symlink ke file database dan gunakan symlink di qpid-server.properties.

    Misalnya, buat symlink untuk "GeoIP2-City-current.mmdb" ke "GeoIP2-City_20160127.mmdb". Jika nantinya Anda menerima database baru dengan nama file yang berbeda, Anda hanya perlu mengupdate symlink, bukan mengonfigurasi ulang dan memulai ulang server Qpid.

  7. Ubah kepemilikan file qpid-server.properties ke pengguna 'apigee':
    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. Picu beberapa panggilan proxy API di contoh proxy API.
    2. Tunggu sekitar 5 - 10 menit hingga agregasi selesai.
    3. Buka konsol dan hubungkan ke server Edge Postgres:
      psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee
    4. Jalankan 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 database Maxmind GeoIp2: 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 pengecualian.

Mengaktifkan Peta Geografis di UI Edge

Gunakan prosedur berikut untuk mengaktifkan Geo Maps 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 menjadi pengguna 'apigee':
    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 data agregasi geografis.

Memperbarui database MaxMind GeoIp2

MaxMind mengeluarkan pembaruan berkala ke database Maxmind GeoIp2. Jika Anda menerima database yang telah diperbarui, gunakan prosedur berikut untuk menginstalnya di Edge:

  1. Dapatkan database Maxmind GeoIp2 yang telah diperbarui.
  2. Download database Maxmind GeoIp2 ke /opt/apigee/maxmind.
  3. Periksa nama file database. Jika file tersebut sama dengan file lama, seperti yang ditetapkan dalam /opt/apigee/customer/application/qpid-server.properties, lanjutkan ke langkah berikutnya. Namun, jika file memiliki nama berbeda, Anda harus mengedit file 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 symlink untuk "GeoIP2-City-current.mmdb" ke "GeoIP2-City_20160127.mmdb". Jika nantinya Anda menerima database baru dengan nama file yang berbeda, Anda cukup mengupdate symlink, bukan mengonfigurasi ulang server Qpid.

  4. Ubah kepemilikan file database ke pengguna 'apigee':
    chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. Tetapkan izin pada 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.