› ›

从事件中替换字段

从事件中替换字段编辑

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

配置设置编辑

Elastic Agent 处理器在摄取管道之前执行，这意味着您的处理器配置不能引用由摄取管道或 Logstash 创建的字段。有关更多限制，请参阅使用处理器的局限性是什么？

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

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

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