启用地理位置汇总和地理地图

地理位置聚合功能可让您根据地理位置 属性（例如区域、大洲、国家/地区和城市）收集 API 调用的分析数据。通过这些分析数据，您可以在新版 Edge 界面中查看 Geomap，其中显示了 API 请求的位置：

新版 Edge 界面中的 GeoMap 信息中心

地理位置聚合功能的工作原理是从第三方数据库中提取地理位置数据，并将其添加到 Edge 收集的分析数据中。地理位置信息可以包含向 API 代理发出的请求的城市、 国家/地区、大洲、时区和区域。

如需使用地理位置聚合功能，您必须购买包含此 地理位置信息的 Maxmind GeoIp2 数据库。如需了解详情，请参阅 https://www.maxmind.com/en/geoip2-databases 。

启用地理位置聚合功能

默认情况下，地理位置聚合功能处于停用状态。如需启用地理位置聚合功能，您必须执行以下操作：

  • 在所有 Qpid 服务器上，安装 MaxMind 数据库并将 Qpid 服务器配置为使用 该数据库。
  • 在新版 Edge 界面中启用地理图显示。

在所有 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/apigee-service/bin/apigee-service edge-qpid-server restart
  9. 在每个 Qpid 节点上重复此过程。
  10. 如需验证地理位置聚合功能是否正常运行，请执行以下操作：
    1. 对示例 API 代理触发多个 API 代理调用。
    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 界面中启用地理位置地图

请按照以下步骤在新版 Edge 界面中启用地理图：

  1. 在 /opt/apigee/customer/application/management-ui.properties 中设置以下令牌以启用地理图。如果该文件不存在，请创建该文件： 
    conf_uebe_disableGeoMap=false
  2. 将 management-ui.properties 文件的所有权更改为 apigee 用户： 
    chown apigee:apigee /opt/apigee/customer/application/management-ui.properties
  3. 重启新版 Edge 界面： 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  4. 在新版 Edge 界面中，依次选择 分析 > 最终用户 > 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/apigee-service/bin/apigee-service edge-qpid-server restart
  7. 在每个 Qpid 节点上重复此过程。