Edge untuk Private Cloud v. 4.17.01
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 lebih lanjut.
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:
- Dapatkan {i>database<i} Maxmind GeoIp2.
Catatan: Agregasi geografis berfungsi dengan menambahkan data geografis dari database pihak ketiga ke data analisis yang dikumpulkan oleh Edge. Untuk menggunakan agregasi geografis, Anda harus membeli database Maxmind GeoIp2 yang berisi informasi ini. Lihat https://www.maxmind.com/en/geoip2-databases untuk mengetahui informasi selengkapnya. - Buat folder berikut pada node server Qpid:
/opt/apigee/maxmind - Download database Maxmind GeoIp2 ke /opt/apigee/maxmind.
- Ubah kepemilikan file database menjadi pengguna 'apigee':
> chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - Tetapkan izin pada database ke 744:
> chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - 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
edit lokasi Max.
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. - Ubah kepemilikan file qpid-server.properties menjadi pengguna 'apigee':
> chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties - Mulai ulang server Qpid:
> /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart - Ulangi proses ini pada setiap node Qpid.
- Untuk memvalidasi bahwa agregasi geografis berfungsi:
- Picu beberapa panggilan proxy API di contoh proxy API.
- Tunggu sekitar 5 - 10 menit hingga agregasi selesai.
- Buka konsol dan hubungkan ke server Edge Postgres:
> psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee - Jalankan kueri SELECT pada tabel analytics.agg_geo untuk menampilkan baris dengan
atribut geografis:
apigee=# 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_region, ax_geo_timezone
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:
- 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 - Ubah kepemilikan file ui.properties menjadi pengguna 'apigee':
> chown apigee:apigee /opt/apigee/customer/application/ui.properties - Mulai ulang UI Edge:
> /opt/apigee/bin/apigee-service/bin/apigee-service edge-ui restart - 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:
- Dapatkan database Maxmind GeoIp2 yang telah diperbarui.
- Download database Maxmind GeoIp2 ke /opt/apigee/maxmind.
- Periksa nama file database. Jika alamat tersebut sama dengan file lama, seperti yang ditentukan di /opt/apigee/customer/application/qpid-server.properties, lanjutkan ke langkah berikutnya. Namun, jika file memiliki nama yang 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. 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. - Ubah kepemilikan file database menjadi pengguna 'apigee':
> chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - Tetapkan izin pada database ke 744:
> chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - Mulai ulang server Qpid:
> /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart - Ulangi proses ini pada setiap node Qpid.