kv

kv #

CategoryScope
Parsingrecord

The “kv” pipeline processor: parse key=value pairs out of a string field — the workhorse for access logs, nginx vars and Java GC output.

Configuration #

FieldTypeDefaultDescription
fieldstringSource field to read from.
field_splitstring" "Separator between key/value pairs.
value_splitstring“=”Separator between a key and its value.
target_fieldstringDestination field to write the result to.
trim_keystringTrim these characters from parsed keys.
trim_valuestringTrim these characters from parsed values.
overwrite_keysboolOverwrite fields that already exist in the record.
ignore_missingboolDo not fail when the source field is missing.
ignore_failureboolDo not fail the record when processing errors; the record passes through unchanged.
tagstringTag appended to the record when processing fails.

Example #

processor:
  - kv:
      field: "message"
      field_split: "field_split"
      value_split: "value_split"
      target_field: "parsed"
      trim_key: "trim_key"
Edit Edit this page