› › ›

字节处理器

字节处理器编辑

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

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

表 5. 字节选项

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

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