Convert processor
The Convert processor converts a field to a different data type. For example, you could convert a string to an integer.
To convert a field to a different data type:
- Select Create → Create processor.
- Select Convert from the Processor menu.
- Set the Source Field to the field you want to convert.
- (Optional) Set Target field to write the converted value to a different field.
- Set Type to the output data type.
If you add a Convert processor inside a condition group (a WHERE block), you must set a Target field.
This functionality uses the Elasticsearch Convert processor internally, but you configure it in Streamlang. Streamlang doesn't always have 1:1 parity with the ingest processor options and behavior. Refer to Processor limitations and inconsistencies.
In YAML mode, configure the convert processor using the following parameters. For the complete Streamlang syntax, refer to the Streamlang reference.
| Parameter | Type | Required | Description |
|---|---|---|---|
from |
string | Yes | Source field containing the value to convert. |
type |
string | Yes | Target data type: integer, long, double, boolean, or string. |
to |
string | No | Target field for the converted value. Defaults to the source field. |
ignore_missing |
boolean | No | When true, skip this processor if the source field is missing. |
When using convert inside a condition (where block), you must set a to field that is different from from.
- action: convert
from: attributes.status_code
type: integer
to: attributes.status_code_int