› › ›

时间戳

时间戳编辑

此功能处于测试阶段，可能会发生变化。设计和代码的成熟度低于正式 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`	否	false	当源字段缺失时忽略错误。
`ignore_failure`	否	false	忽略处理器产生的所有错误。
`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 Translate SID »