添加主机元数据
编辑添加主机元数据编辑
processors: - add_host_metadata: cache.ttl: 5m geo: name: nyc-dc1-rack1 location: 40.7128, -74.0060 continent_name: North America country_iso_code: US region_name: New York region_iso_code: NY city_name: New York
它具有以下设置
-
netinfo.enabled
- (可选) 默认值 true。将 IP 地址和 MAC 地址包含为字段 host.ip 和 host.mac
-
cache.ttl
- (可选) 该处理器使用内部缓存来存储主机元数据。这会设置缓存过期时间。默认值为 5m,负值会完全禁用缓存。
-
geo.name
- (可选) 用户可定义的标记,用于标识离散位置。通常是数据中心、机架或类似的东西。
-
geo.location
- (可选) 以逗号分隔的格式表示的经度和纬度。
-
geo.continent_name
- (可选) 大洲名称。
-
geo.country_name
- (可选) 国家名称。
-
geo.region_name
- (可选) 地区名称。
-
geo.city_name
- (可选) 城市名称。
-
geo.country_iso_code
- (可选) ISO 国家代码。
-
geo.region_iso_code
- (可选) ISO 地区代码。
-
replace_fields
- (可选) 默认值 true。如果设置为 false,则不会用来自
add_host_metadata
的主机字段替换事件中的原始主机字段。
add_host_metadata
处理器会使用主机上的相关元数据来注释每个事件。添加到事件中的字段如下所示
{ "host":{ "architecture":"x86_64", "name":"example-host", "id":"", "os":{ "family":"darwin", "type":"macos", "build":"16G1212", "platform":"darwin", "version":"10.12.6", "kernel":"16.7.0", "name":"Mac OS X" }, "ip": ["192.168.0.1", "10.0.0.1"], "mac": ["00:25:96:12:34:56", "72:00:06:ff:79:f1"], "geo": { "continent_name": "North America", "country_iso_code": "US", "region_name": "New York", "region_iso_code": "NY", "city_name": "New York", "name": "nyc-dc1-rack1", "location": "40.7128, -74.0060" } } }
注意:默认情况下,如果事件中已经存在 Beats 传递的 host.*
字段,add_host_metadata
处理器会覆盖这些字段,前提是 replace_fields
等于 true
。如果该 beat 用于监控外部系统,请使用 add_observer_metadata
。