› › ›

提取数组

此功能为技术预览版，可能会在未来的版本中更改或删除。Elastic 会努力修复任何问题，但技术预览版中的功能不受官方 GA 功能的支持 SLA 约束。

extract_array 处理器使用从数组字段读取的值填充字段。以下示例将使用 my_array 字段的第一个元素填充 source.ip，使用第二个元素填充 destination.ip，并使用第三个元素填充 network.transport。

processors:
  - extract_array:
      field: my_array
      mappings:
        source.ip: 0
        destination.ip: 1
        network.transport: 2

支持以下设置：

field: 要提取其元素的数组字段。
mappings: 将每个字段名称映射到数组索引。使用 0 表示数组中的第一个元素。可以将多个字段映射到同一个数组元素。
ignore_missing: （可选）是否忽略缺少数组字段的事件。默认值为 false，如果指定的字段不存在，将导致事件处理失败。将其设置为 true 可以忽略此条件。
overwrite_keys: 如果映射中指定的目标字段已存在，是否覆盖这些字段。默认值为 false，如果目标字段已存在，将导致处理失败。
fail_on_error: （可选）如果设置为 true 且发生错误，则会回滚对事件的更改，并返回原始事件。如果设置为 false，则即使发生错误也会继续处理。默认值为 true。
omit_empty: （可选）是否从数组中提取空值。如果设置为 true，则不会将目标字段设置为空值，而是保持未设置。空字符串 ("")、空数组 ([]) 或空对象 ({}) 被视为空值。默认值为 false。