时间处理类插件

配置处理插件类型为提取日志时间（Go语言时间格式）。

相关参数说明如下表所示。

参数	说明
原始时间字段	原始字段名。
原始时间格式	原始时间的格式。
原始时间时区	原始时间的时区。选择机器时区时，表示Logtail所在主机或容器的时区。
结果时间字段	解析后的目标字段，该字段不支持设置为__time__。
结果时间格式	解析后的时间格式。
自定义结果时间时区	解析后的时区。选择机器时区时，表示本机的时区。
高级参数>设为日志时间	选中该选项后，系统会将解析后的时间设置为日志时间。
高级参数>保留原始字段	选中该选项后，解析后的日志中将保留原始字段。
高级参数>原始字段缺失报错	选中该选项后，如果原始日志中无您所指定的原始字段，系统将报错。
高级参数>提取失败报错	选中该选项后，如果提取日志时间失败，系统将报错。

原始时间（s_key字段）的格式为2006-01-02 15:04:05（东八区），现将原始时间解析为2006/01/02 15:04:05（东九区）格式，添加到d_key字段中，并设置解析结果为日志服务中的日志时间。

• 原始日志

  "s_key":"2022-07-05 19:28:01"

• Logtail插件处理配置

• 处理结果

  "s_key":"2022-07-05 19:28:01"
  "d_key":"2022/07/05 20:28:01"

配置type为processor_gotime，detail说明如下表所示。

参数	类型	是否必选	说明
SourceKey	String	是	原始字段名。
SourceFormat	String	是	原始时间的格式。
SourceLocation	Int	是	原始时间的时区。参数值为空时，表示Logtail所在主机或容器的时区。
DestKey	String	是	解析后的目标字段，该字段不支持设置为__time__。
DestFormat	String	是	解析后的时间格式。
DestLocation	Int	否	解析后的时区。参数值为空时，表示本机时区。
SetTime	Boolean	否	是否将解析后的时间设置为日志时间。 true（默认值）：是 false：否
KeepSource	Boolean	否	被解析后的日志中是否保留原始字段。 true（默认值）：保留 false：不保留
NoKeyError	Boolean	否	原始日志中无您所指定的原始字段时，系统是否报错。 true（默认值）：报错 false：不报错
AlarmIfFail	Boolean	否	提取日志时间失败，系统是否报错。 true（默认值）：报错 false：不报错

原始时间（s_key字段）的格式为2006-01-02 15:04:05（东八区），现将原始时间解析为2006/01/02 15:04:05（东九区）格式，添加到d_key字段中，并设置解析结果为日志服务中的日志时间。

• 原始日志

  "s_key":"2019-07-05 19:28:01"

• Logtail插件处理配置

  {
    "processors":[
      {
        "type":"processor_gotime",
        "detail": {
          "SourceKey": "s_key",
          "SourceFormat":"2006-01-02 15:04:05",
          "SourceLocation":8,
          "DestKey":"d_key",
          "DestFormat":"2006/01/02 15:04:05",
          "DestLocation":9,
          "SetTime": true,
          "KeepSource": true,
          "NoKeyError": true,
          "AlarmIfFail": true
        }
      }
    ]
  }

• 处理结果

  "s_key":"2019-07-05 19:28:01"
  "d_key":"2019/07/05 20:28:01"（）

配置处理器类型为提取日志时间（strptime时间格式），相关参数说明如下表所示。

参数	说明
原始字段	原始字段名。
原始时间格式	原始时间的格式。
保留原始字段	选中该选项后，被解析后的日志中将保留原始字段。
提取失败报错	选中该选项后，如果提取日志时间失败，系统将报错。
进行时间偏移	选中该选项后，您可以设置时间偏移秒数。
时间偏移秒数	时间偏移秒数。例如28800表示东八区，-3600代表西一区。

将%Y/%m/%d %H:%M:%S格式的原始时间（log_time字段的值）解析为对应的日志时间，时区使用机器所在时区。假设时区为东八区。

• 原始日志

  "log_time":"2022/01/02 12:59:59"

• Logtail插件处理配置

• 处理结果

  "log_time":"2022/01/02 12:59:59"
  Log.Time = 1451710799

配置type为processor_strptime，detail说明如下表所示。

参数	类型	是否必选	说明
SourceKey	String	是	原始字段名。
Format	String	是	原始时间的格式。
AdjustUTCOffset	Boolean	否	是否调整时区。 true：是。 false（默认值）：否
UTCOffset	Int	否	用于调整的时区偏移秒数。例如28800表示东八区。
AlarmIfFail	Boolean	否	提取日志失败时，系统是否报错。 true（默认值）：报错。 false：不报错。
KeepSource	Boolean	否	被解析后的日志中，是否保留原始字段。 true（默认值）：保留。 false：不保留。

将%Y/%m/%d %H:%M:%S格式的原始时间（log_time字段的值）解析为对应的日志时间，时区使用机器所在时区。

• 示例1：假设时区为东八区。

  • 原始日志

    "log_time":"2016/01/02 12:59:59"

  • Logtail插件处理配置

    {
      "processors":[
        {
          "type":"processor_strptime",
          "detail": {
            "SourceKey": "log_time",
            "Format": "%Y/%m/%d %H:%M:%S"
          }
        }
      ]
    }

  • 处理结果

    "log_time":"2016/01/02 12:59:59"
    Log.Time = 1451710799

• 示例2：假设时区为东七区。

  • 原始日志

    "log_time":"2016/01/02 12:59:59"

  • Logtail插件处理配置

    {
      "processors":[
        {
          "type":"processor_strptime",
          "detail": {
            "SourceKey": "log_time",
            "Format": "%Y/%m/%d %H:%M:%S",
            "AdjustUTCOffset": true,
            "UTCOffset": 25200
          }
        }
      ]
    }

  • 处理结果

    "log_time":"2016/01/02 12:59:59"
    Log.Time = 1451714399

• 示例3：假设时区为东七区。

  • 原始日志

    "log_time":"2016/01/02 12:59:59.123"

  • Logtail插件处理配置

    {
      "processors":[
        {
          "type":"processor_strptime",
          "detail": {
            "SourceKey": "log_time",
            "Format": "%Y/%m/%d %H:%M:%S.%f"
          }
        }
      ]
    }

  • 处理结果

    "log_time":"2016/01/02 12:59:59.123"
    Log.Time = 1451714399