追加处理器编辑

append 处理器会将一个或多个值追加到现有数组中(如果目标字段已存在且为数组)。如果字段存在且为标量,则将标量转换为数组,并将一个或多个值追加到该数组。此处,值可以是一个或多个静态值,也可以是 _fields_ 键下列出的字段中的一个或多个值。

target_field
要追加数据的字段。
fields
(可选)要从中复制数据的字段列表。如果该值为具体类型,则会直接将其追加到目标字段。但是,如果该值为数组,则该数组的所有元素都会分别推送到目标字段。
values
(可选)要追加到目标字段的静态值列表。
ignore_empty_values
(可选)如果设置为 true,则所有 ""nil 都将被忽略,不会追加到目标字段。
fail_on_error
(可选)如果设置为 true 并且发生错误,则会还原更改并返回原始值。如果设置为 false,则在发生错误时处理会继续进行。默认值为 true
allow_duplicate
(可选)如果设置为 false,则处理器不会追加字段中已存在的值。默认值为 true,这会在数组中追加重复值。
ignore_missing
(可选)指示是否忽略缺少源字段的事件。默认值为 false,这会在缺少字段时导致事件处理失败。

注意:如果要将 fields 参数与 message 下的字段一起使用,请确保先使用 decode_json_fields,并将 target 设置为 ""

例如,此配置

processors:
  - decode_json_fields:
      fields: message
      target: ""
  - append:
      target_field: target-field
      fields:
        - concrete.field
        - array.one
      values:
        - static-value
        - ""
      ignore_missing: true
      fail_on_error: true
      ignore_empty_values: true

concrete.fieldarray.one 响应字段的值和静态值复制到 target-field

{
  "concrete": {
    "field": "val0"
  },
  "array": {
      "one": [ "val1", "val2" ]
  },
  "target-field": [
    "val0",
    "val1",
    "val2",
    "static-value"
  ]
}