› › ›

字节处理器

将人类可读的字节值（例如 1kb）转换为其字节值（例如 1024）。如果字段是字符串数组，则数组的所有成员都将被转换。

支持的人类可读单位不区分大小写，包括 "b"、"kb"、"mb"、"gb"、"tb"、"pb"。如果字段不是支持的格式或结果值超过 2^63，则会发生错误。

表 5. 字节选项

名称	必需	默认	描述
`field`	是	-	要转换的字段
`target_field`	否	`field`	将转换后的值分配到的字段，默认情况下，`field` 会被就地更新
`ignore_missing`	否	`否`	如果为 `true` 且 `field` 不存在或为 `null`，则处理器会静默退出而不修改文档
`description`	否	-	处理器的描述。用于描述处理器的目的或其配置。
`if`	否	-	有条件地执行处理器。请参阅有条件地运行处理器。
`ignore_failure`	否	`否`	忽略处理器的故障。请参阅处理管道故障。
`on_failure`	否	-	处理处理器的故障。请参阅处理管道故障。
`tag`	否	-	处理器的标识符。对调试和指标很有用。

{
  "bytes": {
    "field": "file.size"
  }
}