替换事件中的字段编辑

replace 处理器接收一个字段列表,搜索匹配的值,并将匹配的值替换为指定的字符串。

replace 处理器不能用于创建全新的值。

您可以使用此处理器截断字段值或将其替换为新的字符串值。您还可以使用此处理器屏蔽 PII 信息。

示例编辑

以下示例将路径从 /usr/bin 更改为 /usr/local/bin

  - replace:
      fields:
        - field: "file.path"
          pattern: "/usr/"
          replacement: "/usr/local/"
      ignore_missing: false
      fail_on_error: true

配置设置编辑

名称 必需 默认 描述

字段

一个或多个项目的列表。每个项目包含 field: field-namepattern: regex-patternreplacement: replacement-string,其中

  • field 是原始字段名称。您可以在此字段中使用 @metadata. 前缀来替换事件元数据中的值,而不是事件字段。
  • pattern 是与字段值匹配的正则表达式模式
  • replacement 是用于更新字段值的替换字符串

ignore_missing

false

是否忽略缺少的字段。如果为 true,则在指定的字段缺失时不会记录错误。

fail_on_error

true

如果发生错误,是否停止替换字段值。如果为 true 并且发生错误,则停止替换字段值,并返回原始事件。如果为 false,即使在替换过程中发生错误,替换也会继续进行。

有关支持的条件列表,请参阅条件