› › ›

移除处理器

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

表 37. 移除选项

名称	必需	默认值	描述
`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"]
  }
}