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

地理位置匯總功能可讓您根據地理屬性 (例如區域、洲別、國家/地區和城市) 收集 API 呼叫的 Analytics 資料。您可以從這項分析資料，在 Edge UI 中查看 GeoMap，瞭解 API 要求的來源位置：

地理位置匯總功能會從第三方資料庫擷取地理資料，並將其新增至 Edge 收集的 Analytics 資料。地理資訊可能包含向 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 中啟用 Geo Maps

如要在 Edge UI 中啟用 Geo Maps，請按照下列程序操作：

  1. 在 /opt/apigee/customer/application/ui.properties 中設定下列權杖，即可啟用地理地圖。如果該檔案不存在，請建立檔案： 
    conf_apigee_apigee.feature.disablegeomap=false
     中的屬性 conf_apigee_apigee.feature.disablegeomap 設為 true。
  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 節點上重複執行這個程序。