添加主机元数据编辑

默认情况下,收集日志和指标的输入使用此处理器,因此您无需显式配置它。

add_host_metadata 处理器使用主机机器的相关元数据对每个事件进行注释。

如果您使用 Elastic Agent 监控外部系统,请使用 add_observer_metadata 处理器,而不是 add_host_metadata

示例编辑

  - 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

添加到事件的字段如下所示

{
   "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"
        }
   }
}

配置设置编辑

Elastic Agent 处理器在摄取管道之前执行,这意味着它们处理原始事件数据,而不是发送到 Elasticsearch 的最终事件。有关相关限制,请参阅 使用处理器的局限性是什么?

如果事件中已存在 host.* 字段,则默认情况下它们会被覆盖,除非您在处理器配置中将 replace_fields 设置为 true

名称 必需 默认值 描述

netinfo.enabled

true

是否将 IP 地址和 MAC 地址作为字段 host.iphost.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 中的主机字段替换。