Decode CSV fields
Warning
This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features.
Thedecode_csv_fields processor decodes fields containing records in comma-separated format (CSV). It will output the values as an array of strings.
Note
This processor only works with log inputs.
- decode_csv_fields: fields: message: decoded.csv separator: "," ignore_missing: false overwrite_keys: true trim_leading_space: false fail_on_error: trueNote
Elastic Agent processors executebefore ingest pipelines, which means that your processor configurations cannot refer to fields that are created by ingest pipelines or Logstash. For more limitations, refer toWhat are some limitations of using processors?
| Name | Required | Default | Description |
|---|---|---|---|
fields | Yes | A mapping from the source field containing the CSV data to the destination field to which the decoded array will be written. | |
separator | No | comma character (,) | Character to use as a column separator. To use a TAB character, set this value to "\t". |
ignore_missing | No | false | Whether to ignore events that lack the source field. Iffalse, events missing the source field will fail processing. |
overwrite_keys | No | false | Whether the target field is overwritten if it already exists. Iffalse, processing of an event fails if the target field already exists. |
trim_leading_space | No | false | Whether extra space after the separator is trimmed from values. This works even if the separator is also a space. |
fail_on_error | No | true | Whether to fail if an error occurs. Iftrue and an error occurs, any changes to the event are reverted, and the original event is returned. Iffalse, processing continues even if an error occurs. |