转换字段类型编辑

convert 处理器将事件中的字段转换为不同的类型,例如将字符串转换为整数。

支持的类型包括:integerlongfloatdoublestringbooleanip

ip 类型实际上是 string 的别名,但增加了对值是 IPv4 或 IPv6 地址的验证。

示例编辑

  - convert:
      fields:
        - {from: "src_ip", to: "source.ip", type: "ip"}
        - {from: "src_port", to: "source.port", type: "integer"}
      ignore_missing: true
      fail_on_error: false

配置设置编辑

Elastic Agent 处理器在摄取管道之前执行,这意味着您的处理器配置不能引用由摄取管道或 Logstash 创建的字段。有关更多限制,请参阅 使用处理器的局限性是什么?

名称 必需 默认值 描述

fields

要转换的字段列表。列表必须包含至少一项。每个项目必须具有一个 from 键,指定源字段。 to 键是可选的,指定将转换后的值分配到哪里。如果省略 to,则 from 字段将就地更新。 type 键指定要将值转换到的数据类型。如果省略 type,则处理器将在不进行任何类型转换的情况下复制或重命名字段。

ignore_missing

false

是否忽略缺少的 from 键。如果为 true 并且在事件中找不到 from 键,则处理器将继续处理下一个字段。如果为 false,则处理器将返回错误,并且不会处理剩余的字段。

fail_on_error

true

是否在发生类型转换错误时失败。如果为 false,则类型转换失败将被忽略,处理器将继续处理下一个字段。

tag

此处理器的标识符。对调试很有用。

mode

copy

当为字段定义了 fromto 时, mode 控制在类型转换成功时是 copy 还是 rename 字段。