GeoEnrichIP
描述:
查看IP地址所在的地理位置，并将其地理位置的信息添加到流文件属性中。地理信息由MaxMind数据源提供。在‘IP地址属性名’中指定包含该IP地址的流文件属性的名称。如果前置流文件中有一个名为'X'的流文件属性，然后在‘IP地址属性名’中指定使用该'X'，则后续检索出来的IP地址相关的地理信息都将以 X.geo.<地理特征名称>。
标签:
geo, enrich, ip, maxmind
参数:
如下列表中，必填参数则标识为加粗. 其他未加粗参数，则表示为可选参数。表中同时提到参数默认值设置, 并且 参数还支持 表达式语言.
| 名字 | 默认值 | 允许值列表 | 描述 |
|---|---|---|---|
| MaxMind 数据库文件 | 指向Maxmind数据库文件的文件路径。 | ||
| IP地址属性名称 | 用于检索其地理位置信息的IP地址属性名称。前置流文件中所包含IP地址的属性项，所检索出的结果会以该属性名称开头。比如：在此处配置baidu.serviceIP(该属性在前置流文件的内容为220.181.111.37)，经本组件的检索处理后，得到的结果为：[baidu.serviceIP.geo.city Beijing],[baidu.serviceIP.geo.latitude 39.9288],[baidu.serviceIP.geo.longitude 116.3889]等等的以baidu.serviceIP.geo.<地理特征名称>的属性。 支持表达式语言 (支持流属性和变量) |
连线:
| 名字 | 描述 |
|---|---|
| not found | 无检索数据关联，当给定的IP地址属性名称查询无相关的结果，则路由原始流文件到该关联。 |
| found | 找到查询数据关联，当给定的IP地址属性名称查询到相关结果，则路由原始文件到该关联。 |
读取属性:
未提供。
写入属性:
| 名字 | 描述 |
|---|---|
| X.geo.lookup.micros | 查询所消耗的时间，单位为微妙µs（10^-6 seconds） |
| X.geo.city | IP地址映射所在的城市。 |
| X.geo.accuracy | 精确的半径（如果数据库有提供）,单位为km。 |
| X.geo.latitude | IP地址映射所在的纬度。 |
| X.geo.longitude | IP地址映射所在的经度。 |
| X.geo.subdivision.N | IP地址映射所包含的每个地理分支，N由0开始，逐一追加在属性名称后面。 |
| X.geo.subdivision.isocode.N | 地理分支的ISO代号，对应X.geo.subdivision.N属性。 |
| X.geo.country | IP地址映射所在的国家。 |
| X.geo.country.isocode | 国家的ISO代号，对应X.geo.country。 |
| X.geo.postalcode | 邮政编码。 |
状态管理:
该组件不保存状态。
限制:
该组件没有限制
输入流要求:
组件必须提供输入流。
系统资源考量:
未提供。