利用地理位置汇总,您可以根据区域、大洲、国家/地区和城市等地理属性收集 API 调用的分析数据。根据这些分析数据,您可以在 Edge 界面中查看显示 API 请求位置的地理图:
地理位置汇总的运作方式是从第三方数据库提取地理位置数据,并将其添加到 Edge 收集的分析数据中。地理信息可以包含向 API 代理发出的请求对应的城市、国家/地区、大洲、时区和区域。
如需使用地理位置汇总,您必须购买包含此地理位置信息的 Maxmind GeoIp2 数据库。如需了解详情,请参阅 https://www.maxmind.com/en/geoip2-databases。
启用地理位置汇总
默认情况下,地理位置汇总功能处于停用状态。若要启用地理位置汇总,您必须执行以下操作:
- 在所有 Qpid 服务器上,安装 MaxMind 数据库并将 Qpid 服务器配置为使用该数据库。
- 在 Edge 界面中启用地理分布图显示。
在所有 Edge Qpid 服务器上安装 MaxMind 数据库
请按照以下步骤在所有 Edge Qpid 服务器上安装 MaxMind 数据库:
- 获取 Maxmind GeoIp2 数据库。
- 在 Qpid 服务器节点上创建以下文件夹:
/opt/apigee/maxmind
- 将 Maxmind GeoIp2 数据库下载到
/opt/apigee/maxmind
。 - 将数据库文件的所有权更改为“apigee”用户:
chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
- 将数据库权限设置为 744:
chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
- 在
/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 服务器。
- 将
qpid-server.properties
文件的所有权更改为“apigee”用户:chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties
- 重启 Qpid 服务器:
/opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart
- 对每个 Qpid 节点重复此过程。
- 如需验证地理位置汇总功能是否正常运行,请执行以下操作:
- 在示例 API 代理上触发多个 API 代理调用。
- 等待汇总完成,大约需要 5-10 分钟。
- 打开控制台并连接到 Edge Postgres 服务器:
psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee
- 对 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 界面中启用地理地图:
- 在
/opt/apigee/customer/application/ui.properties
中设置以下令牌以启用地理地图。如果该文件不存在,请创建一个:conf_apigee_apigee.feature.disablegeomap=false
- 将 ui.properties 文件的所有权更改为“apigee”用户:
chown apigee:apigee /opt/apigee/customer/application/ui.properties
- 重启 Edge 界面:
/opt/apigee/bin/apigee-service/bin/apigee-service edge-ui restart
- 在 Edge 界面中,依次选择 Analytics > GeoMap,以显示地理汇总数据。
更新 MaxMind GeoIp2 数据库
MaxMind 会定期对 Maxmind GeoIp2 数据库进行更新。如果您收到更新后的数据库,请按照以下步骤将其安装在 Edge 上:
- 获取更新后的 Maxmind GeoIp2 数据库。
- 将 Maxmind GeoIp2 数据库下载到
/opt/apigee/maxmind
。 - 检查数据库文件的名称。如果它与
/opt/apigee/customer/application/qpid-server.properties
中定义的旧文件相同,请继续执行下一步。 但是,如果该文件具有不同的名称,则必须修改qpid-server.properties
文件以指定新数据库文件的名称,然后重启 Qpid 服务器,如上所述。作为替代方法,您可以创建指向该文件的符号链接。例如,为“GeoIP2-City-current.mmdb”创建一个符号链接,指向“GeoIP2-City_20160127.mmdb”。如果您以后收到具有不同文件名的新数据库,只需更新符号链接,而不必重新配置 Qpid 服务器。
- 将数据库文件的所有权更改为“apigee”用户:
chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
- 将数据库权限设置为 744:
chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
- 重启 Qpid 服务器:
/opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart
- 对每个 Qpid 节点重复此过程。