› › ›

时间戳

此功能处于测试阶段，可能会发生变化。其设计和代码不如正式 GA 功能成熟，按现状提供，不提供任何担保。测试版功能不受正式 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 中的当前年份添加到时间值。

表 4. 时间戳选项

名称	必填	默认值	描述
`field`	是		包含要解析时间的源字段。
`target_field`	否	@timestamp	解析时间值的目標字段。目标值始终以 UTC 写入。
`layouts`	是		定义预期时间值格式的时间戳布局。此外，还接受 `UNIX` 和 `UNIX_MS` 布局。
`timezone`	否	UTC	IANA 时区名称（例如 `America/New_York`）或固定时间偏移量（例如 `+0200`），用于解析不包含时区的时间。可以指定 `Local` 来使用机器的本地时区。
`ignore_missing`	否	否	源字段缺失时忽略错误。
`ignore_failure`	否	否	忽略处理器产生的所有错误。
`test`	否		加载处理器时必须成功解析的时间戳列表。
`id`	否		此处理器实例的标识符。对调试很有用。

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

processors:
  - 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]

« Syslog 转换 SID »