时间戳

编辑

此功能处于 Beta 阶段,可能会发生变化。设计和代码不如正式 GA 功能成熟,按原样提供,不提供任何保证。Beta 功能不受官方 GA 功能的支持 SLA 约束。

timestamp 处理器从字段中解析时间戳。默认情况下,时间戳处理器将解析结果写入 @timestamp 字段。您可以通过设置 target_field 参数来指定不同的字段。时间戳值根据 layouts 参数进行解析。可以指定多个布局,它们将按顺序用于尝试解析时间戳字段。

此处理器使用的时间戳布局与 Logstash 和 Elasticsearch Ingest Node 中日期处理器支持的格式不同。

layouts 使用基于此特定时间的参考时间进行描述

Mon Jan 2 15:04:05 MST 2006

由于 MST 是 GMT-0700,因此参考时间为

01/02 03:04:05PM '06 -0700

要定义您自己的布局,请以与您期望解析的时间戳匹配的格式重写参考时间。有关更多布局示例和详细信息,请参阅 Go 时间包文档

如果布局不包含年份,则会将指定 timezone 中的当前年份添加到时间值。

示例

编辑

这是一个解析 start_time 字段并将结果写入 @timestamp 字段,然后删除 start_time 字段的示例。加载处理器后,它将立即验证这两个 test 时间戳是否可以使用此配置进行解析。

  - timestamp:
      field: start_time
      layouts:
        - '2006-01-02T15:04:05Z'
        - '2006-01-02T15:04:05.999Z'
        - '2006-01-02T15:04:05.999-07:00'
      test:
        - '2019-06-22T16:33:51Z'
        - '2019-11-18T04:59:51.123Z'
        - '2020-08-03T07:10:20.123456+02:00'
  - drop_fields:
      fields: [start_time]

配置设置

编辑

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

名称 必需 默认 描述

字段

包含要解析的时间的源字段。

目标字段

@timestamp

解析时间值的目标字段。目标值始终以 UTC 写入。

布局

定义预期时间值格式的时间戳布局。此外,还接受 UNIXUNIX_MS

时区

UTC

IANA 时区名称(例如,America/New_York)或固定时间偏移量(例如,+0200),用于解析不包含时区的时间。指定 Local 以使用机器的本地时区。

忽略缺失

是否在源字段丢失时忽略错误。

忽略失败

是否忽略处理器产生的所有错误。

测试

加载处理器时必须成功解析的时间戳列表。

ID

此处理器实例的标识符。用于调试。