› › ›

替换事件中的字段

编辑

替换事件中的字段

编辑

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

配置设置

编辑

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

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

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