Simple Log Service:時間処理プラグイン

処理プラグインの種類 を ログ時間の抽出 (Golang の時間形式) に設定します。

パラメーター：

パラメーター	説明
[元の時間フィールド]	解析対象の時間を含むフィールド名です。
[元の時間形式]	ソースフィールドの Go 時間形式の文字列です。
[元の時間タイムゾーン]	ソース時間のタイムゾーンです。システムタイムゾーン を選択した場合、Logtail はホストまたはコンテナのタイムゾーンを使用します。
[結果時間フィールド]	解析・フォーマット後の時間を格納するフィールド名です。このパラメーターを __time__ に設定することはできません。
[結果時間形式]	宛先フィールドの Go 時間形式の文字列です。
[カスタム結果時間タイムゾーン]	宛先フィールドのタイムゾーンです。システムタイムゾーン を選択した場合、Logtail はホストまたはコンテナのタイムゾーンを使用します。
[高度なパラメーター] > ログ時間に設定	解析された時間をログ時間として使用するかどうかを指定します。
[高度なパラメーター > ][元のフィールドの保持]	処理後のログでソースフィールドを保持するかどうかを指定します。
[[詳細設定 > ]ソースフィールドが存在しない場合にエラーを報告する]	生ログにソースフィールドが見つからない場合にエラーを報告するかどうかを指定します。
[[高度なパラメーター > ]抽出失敗時にエラーを報告]	時間の抽出に失敗した場合にエラーを報告するかどうかを指定します。

s_key フィールドを 2006-01-02 15:04:05 形式 (UTC+8) で解析し、2006/01/02 15:04:05 (UTC+9) に変換して、結果を 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	文字列	はい	解析対象の時間を含むフィールド名です。
SourceFormat	文字列	はい	ソースフィールドの Go 時間形式の文字列です。
SourceLocation	整数	いいえ	ソースタイムゾーンの UTC オフセット (単位：時間) です。たとえば、UTC+8 の場合は 8 を使用します。このパラメーターを指定しない場合、Logtail はホストまたはコンテナのタイムゾーンを使用します。
DestKey	文字列	はい	解析・フォーマット後の時間を格納するフィールド名です。このパラメーターを __time__ に設定することはできません。
DestFormat	文字列	はい	宛先フィールドの Go 時間形式の文字列です。
DestLocation	整数	いいえ	宛先タイムゾーンの UTC オフセット (単位：時間) です。このパラメーターを指定しない場合、Logtail はホストまたはコンテナのタイムゾーンを使用します。
SetTime	ブール値	いいえ	解析された時間をログ時間として使用するかどうかを指定します。 true (デフォルト)：解析された時間をログ時間として使用します。 false：解析された時間をログ時間として使用しません。
KeepSource	ブール値	いいえ	処理後のログでソースフィールドを保持するかどうかを指定します。 true (デフォルト)：ソースフィールドを保持します。 false：ソースフィールドを破棄します。
NoKeyError	ブール値	いいえ	生ログにソースフィールドが見つからない場合にエラーを報告するかどうかを指定します。 true (デフォルト)：エラーを報告します。 false：エラーを報告しません。
AlarmIfFail	ブール値	いいえ	時間の抽出に失敗した場合にエラーを報告するかどうかを指定します。 true (デフォルト)：エラーを報告します。 false：エラーを報告しません。

s_key フィールドを 2006-01-02 15:04:05 形式 (UTC+8) で解析し、2006/01/02 15:04:05 (UTC+9) に変換して、結果を 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 は UTC+8 を、-3600 は UTC-1 を示します。

log_time フィールドから %Y/%m/%d %H:%M:%S 形式の時刻を解析し、それをログ時間として設定します。ホストのタイムゾーンが UTC+8 であると仮定します。

• 生ログ

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

• Logtail プラグイン設定

• 処理結果

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

type を processor_strptime に設定します。detail オブジェクトのパラメーターは次のとおりです。

パラメーター	タイプ	必須	説明
SourceKey	String	はい	ソースフィールドの名前です。
Format	String	はい	ソース時刻のフォーマットです。
AdjustUTCOffset	Boolean	いいえ	タイムゾーンを調整するかどうかを指定します。 true：タイムゾーンを調整します。 false (デフォルト)：タイムゾーンを調整しません。
UTCOffset	Int	いいえ	タイムゾーンオフセット (秒単位) です。この設定は、AdjustUTCOffset が true の場合にのみ適用されます。
AlarmIfFail	Boolean	いいえ	プラグインがログ時間の抽出に失敗した場合にアラームを生成するかどうかを指定します。 true (デフォルト)：アラームを生成します。 false：アラームを生成しません。
KeepSource	Boolean	いいえ	処理後のログでソースフィールドを保持するかどうかを指定します。 true (デフォルト)：ソースフィールドを保持します。 false：ソースフィールドを破棄します。

log_time フィールドから %Y/%m/%d %H:%M:%S 形式の時刻を解析し、それをログ時間として設定します。Logtail はホストマシンのタイムゾーンを使用します。

• 例 1：タイムゾーンが UTC+8 であると仮定します。

  • 生ログ

    "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：タイムゾーンが UTC+7 であると仮定します。

  • 生ログ

    "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：タイムゾーンが UTC+7 であると仮定します。

  • 生ログ

    "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