啟用地理區域匯總和地理區域地圖

地理區域匯總功能可讓您根據地理區域、洲別、國家/地區和城市等地理區域屬性,收集 API 呼叫的分析資料。您可以透過這些數據分析資料,在 Edge UI 中查看顯示 API 要求位置的 GeoMap:

地理區域匯總作業是從第三方資料庫擷取地理資料,然後新增至 Edge 收集的數據分析資料。地理位置資訊可能包含向 API Proxy 發出要求的城市、國家/地區、洲別、時區和區域。

如要使用地理區域匯總功能,您必須購買包含這項地理位置資訊的 Maxmind GeoIp2 資料庫。詳情請參閱 https://www.maxmind.com/en/geoip2-databases

啟用地理區域匯總

根據預設,系統不會啟用地理區域匯總功能。如要啟用地理區域匯總,您必須:

  • 在所有 Qpid 伺服器上,安裝 MaxMind 資料庫並設定 Qpid 伺服器來使用。
  • 在 Edge UI 中啟用地理區域地圖顯示功能。

在所有 Edge Qpid 伺服器上安裝 MaxMind 資料庫

請按照下列程序在所有 Edge Qpid 伺服器上安裝 MaxMind 資料庫:

  1. 取得 Maxmind GeoIp2 資料庫。
  2. 在 Qpid 伺服器節點中建立下列資料夾:
    /opt/apigee/maxmind
  3. 將 Maxmind GeoIp2 資料庫下載至 /opt/apigee/maxmind
  4. 將資料庫檔案的擁有權變更為「apigee」使用者:
    chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. 將資料庫的權限設為 744:
    chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. 請在 /opt/apigee/customer/application/qpid-server.properties 中設定下列權杖。如果該檔案不存在,請建立檔案:
    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 資料庫儲存在其他位置,請據此編輯路徑屬性。

    請注意,這個資料庫檔案包含版本號碼。如果您之後收到更新過的資料庫檔案,則檔案版本號碼可能不同。或者,您也可以建立資料庫檔案的符號連結,並在 qpid-server.properties 中使用符號連結。

    舉例來說,建立「GeoIP2-City-current.mmdb」到「GeoIP2-City_20160127.mmdb」的符號連結。如果日後收到檔名不同的新資料庫,您只需要更新符號連結,而不必重新設定及重新啟動 Qpid 伺服器。

  7. qpid-server.properties 檔案的擁有權變更為「apigee」使用者:
    chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties
  8. 重新啟動 Qpid 伺服器:
    /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart
  9. 針對每個 Qpid 節點重複執行這項程序。
  10. 如何確認地理區域匯總作業是否正常運作:
    1. 在 API Proxy 範例上觸發多個 API Proxy 呼叫。
    2. 匯總約需 5 到 10 分鐘才能完成。
    3. 開啟控制台並連線至 Edge Postgres 伺服器:
      psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee
    4. 對資料表 analytics.agg_geo 執行 SELECT 查詢,顯示具有地理區域屬性的資料列:
      select * from analytics.agg_geo;

      您應該會在查詢結果中看到從 Maxmind GeoIp2 資料庫擷取的下列資料欄:ax_geo_city, ax_geo_country, ax_geo_continent, ax_geo_timezone, ax_geo_region

      如果系統未填入 agg_geo 資料表,請查看 /opt/apigee/var/log/edge-qpid-server/logs/ 的 Qpid 伺服器記錄檔,以偵測任何潛在的例外狀況。

在 Edge UI 中啟用地理區域地圖

請按照下列程序在 Edge UI 中啟用地理區域地圖:

  1. /opt/apigee/customer/application/ui.properties 中設定下列權杖,即可啟用地理區域地圖。如果該檔案不存在,請建立檔案:
    conf_apigee_apigee.feature.disablegeomap=false
  2. 將 ui.properties 檔案的擁有權變更為「apigee」使用者:
    chown apigee:apigee /opt/apigee/customer/application/ui.properties
  3. 重新啟動 Edge UI:
    /opt/apigee/bin/apigee-service/bin/apigee-service edge-ui restart
  4. 在 Edge UI 中,依序選取「Analytics」>「GeoMap」,即可顯示地理區域匯總資料。

更新 MaxMind GeoIp2 資料庫

MaxMind 會定期更新 Maxmind GeoIp2 資料庫的定期更新。收到更新過的資料庫後,請按照下列程序在 Edge 上安裝資料庫:

  1. 取得更新後的 Maxmind GeoIp2 資料庫。
  2. 將 Maxmind GeoIp2 資料庫下載至 /opt/apigee/maxmind
  3. 檢查資料庫檔案名稱。如果與 /opt/apigee/customer/application/qpid-server.properties 中定義的舊檔案相同,請繼續下一個步驟。不過,如果檔案名稱不同,您必須按照上述說明編輯 qpid-server.properties 檔案,指定新的資料庫檔案名稱,然後重新啟動 Qpid 伺服器。

    您也可以建立檔案的符號連結。舉例來說,建立「GeoIP2-City-current.mmdb」到「GeoIP2-City_20160127.mmdb」的符號連結。如果之後收到檔名不同的新資料庫,您只需要更新符號連結,而不必重新設定 Qpid 伺服器。

  4. 將資料庫檔案的擁有權變更為「apigee」使用者:
    chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. 將資料庫的權限設為 744:
    chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. 重新啟動 Qpid 伺服器:
    /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart
  7. 針對每個 Qpid 節點重複執行這項程序。