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

Private Cloud v4.19.01 版

地理區域匯總功能可讓您依據地理位置收集 API 呼叫的數據分析資料 例如區域、洲別、國家/地區和城市您可以透過這些分析資料 Edge UI 中的 GeoMap，顯示 API 要求的位置：

地理區域匯總功能的運作方式是從第三方資料庫擷取地理資料，然後新增 以便將資料遷移至 Edge 收集的數據分析資料地理位置資訊可以包含城市、 對 API Proxy 提出要求的國家/地區、洲別、時區和區域。

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

啟用地理區域匯總功能

在預設情況下，系統不會啟用地理區域匯總功能。如要啟用地理區域匯總功能，您必須：

  • 在所有 Qpid 伺服器上安裝 MaxMind 資料庫，並設定要使用的 Qpid 伺服器 基礎架構
  • 在 Edge UI 中啟用地理區域地圖顯示功能。

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

請按照下列程序在所有 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 資料表，請檢查 Qpid 伺服器記錄： /opt/apigee/var/log/edge-qpid-server/logs/，偵測出 例外狀況。

在 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 節點重複這個程序。