› › ›

从事件中替换字段

从事件中替换字段edit

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

replace 处理器不能用来创建一个全新的值。

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

示例edit

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

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

配置设置edit

名称	必填	默认值	描述
`fields`	是		一个或多个项目的列表。每个项目包含一个 `field: field-name`、`pattern: regex-pattern` 和 `replacement: replacement-string`，其中 `field` 是原始字段名。您可以在此字段中使用 `@metadata.` 前缀来替换事件元数据中的值，而不是事件字段。 `pattern` 是与字段值匹配的正则表达式模式 `replacement` 是用来更新字段值的替换字符串
`ignore_missing`	否	`false`	是否忽略缺失的字段。如果为 `true`，则如果指定字段缺失，不会记录错误。
`fail_on_error`	否	`true`	如果出现错误，是否失败替换字段值。如果为 `true` 并且出现错误，则字段值的替换将停止，并返回原始事件。如果为 `false`，则即使替换过程中出现错误，替换也会继续。

有关支持的条件的列表，请参见条件。

« 从事件中重命名字段脚本处理器 »