› › ›

移除处理器

移除处理器编辑

移除现有字段。如果一个字段不存在，将抛出异常。

表 36. 移除选项

名称	必需	默认值	描述
`field`	是	-	要移除的字段。支持模板片段。
`ignore_missing`	否	`false`	如果 `true` 且 `field` 不存在或为 `null`，处理器将静默退出，不会修改文档。
`keep`	否	-	要保留的字段。设置后，除指定字段外的所有字段都将被移除。
`description`	否	-	处理器的描述。用于描述处理器的用途或其配置。
`if`	否	-	有条件地执行处理器。参见有条件地运行处理器。
`ignore_failure`	否	`false`	忽略处理器的失败。参见处理管道失败。
`on_failure`	否	-	处理处理器的失败。参见处理管道失败。
`tag`	否	-	处理器的标识符。用于调试和指标。

以下是一个移除单个字段的示例

{
  "remove": {
    "field": "user_agent"
  }
}

要移除多个字段，可以使用以下查询

{
  "remove": {
    "field": ["user_agent", "url"]
  }
}

您也可以选择移除除指定列表以外的所有字段

{
  "remove": {
    "keep": ["url"]
  }
}