Bytes processor

Converts a human readable byte value (e.g. 1kb) to its value in bytes (e.g. 1024). If the field is an array of strings, all members of the array will be converted.

Supported human readable units are “b”, “kb”, “mb”, “gb”, “tb”, “pb” case insensitive. An error will occur if the field is not a supported format or resultant value exceeds 2^63.

Table 4. Bytes Options

NameRequiredDefaultDescription

field

yes

-

The field to convert

target_field

no

field

The field to assign the converted value to, by default field is updated in-place

ignore_missing

no

false

If true and field does not exist or is null, the processor quietly exits without modifying the document

if

no

-

Conditionally execute this processor.

on_failure

no

-

Handle failures for this processor. See Handling Failures in Pipelines.

ignore_failure

no

false

Ignore failures for this processor. See Handling Failures in Pipelines.

tag

no

-

An identifier for this processor. Useful for debugging and metrics.

  1. {
  2. "bytes": {
  3. "field": "file.size"
  4. }
  5. }