转换 IP 地址插件--日志服务-火山引擎

文档中心

立即注册

导航

日志服务

转换 IP 地址插件

最近更新时间：2025.02.28 16:29:38首次发布时间：2025.02.28 16:29:38

您可以使用 LogCollector 的 geoip 插件将 IP 地址为地理位置（国家、省份、城市、经纬度）。

说明

LogCollector V2.3.0 及后续版本支持该插件。如何查看LogCollector版本，请参考查看软件版本。

参数说明

名称	类型	是否必选	说明
field	String	是	待进行 IP 地址转换的日志字段。
mmdb_path	String	是	GeoIP 数据库路径。
language	String	否	语言属性，默认为 zh-CN。
city_field	String	否	存放城市信息的字段，默认为 city。
province_field	String	否	存放省份信息的字段，默认为 province。
country_field	String	否	存放国家信息的字段，默认为 country。
longitude_field	String	否	存放经度信息的字段，默认为 longitude。
latitude_field	String	否	存放纬度信息的字段，默认为 latitude。
allow_empty_values	Boolean	否	`field` 中指定字段的值经解析后，如果某个子字段值为空，是否保留此键值对。 true：保留。 false（默认）：不保留。
allow_overwrite_keys	Boolean	否	如果 `keys` 中指定的 key 与采集配置中已存在的 key 重复时，是否覆盖已存在 key 对应的字段。 true：覆盖。 false（默认）：key 重复时，LogCollector 插件配置执行失败。

配置示例

原始日志
```
"ip" : "**.**.**.**"
```

LogCollector 插件配置

{
    "processors": [
        {
            "geoip": {
                "field": "ip",
                "mmdb_path": "/usr/local/data/GeoLite2-City_20181002/GeoLite2-City.mmbd",
            }
        }
    ]
}

处理结果

"ip": "**.**.**.**
"city": "北京"
"province": "BJ"
"country": "CN"
"longitude": "116.********"
"latitude": "40.********"