日付プロセッサ

フィールドから日付を解析し、その後、日付またはタイムスタンプをドキュメントのタイムスタンプとして使用します。デフォルトでは、日付プロセッサは解析された日付を @timestamp という新しいフィールドとして追加します。 target_field 設定パラメータを設定することで、別のフィールドを指定できます。同じ日付プロセッサ定義の一部として複数の日付形式がサポートされています。これらは、プロセッサ定義の一部として定義された順序で、日付フィールドの解析を試みるために順次使用されます。


表 11. 日付オプション

名前 必須 デフォルト 説明
field はい - 日付を取得するフィールド。
target_field いいえ @timestamp 解析された日付を保持するフィールド。
formats はい - 期待される日付形式の配列。 java time pattern または次の形式のいずれかである必要があります: ISO8601, UNIX, UNIX_MS, または TAI64N。
timezone いいえ UTC 日付を解析する際に使用するタイムゾーン。 テンプレートスニペットをサポートしています。
locale いいえ ENGLISH 日付を解析する際に使用するロケール。月名や曜日を解析する際に関連します。テンプレートスニペットをサポートしています。
output_format いいえ yyyy-MM-dd'T'HH:mm:ss.SSSXXX target_field に日付を書き込む際に使用する形式。 有効な java time pattern である必要があります。
description いいえ - プロセッサの説明。プロセッサの目的や設定を説明するのに役立ちます。
if いいえ - プロセッサを条件付きで実行します。プロセッサを条件付きで実行するを参照してください。
ignore_failure いいえ false プロセッサの失敗を無視します。パイプラインの失敗を処理するを参照してください。
on_failure いいえ - プロセッサの失敗を処理します。パイプラインの失敗を処理するを参照してください。
tag いいえ - プロセッサの識別子。デバッグやメトリクスに役立ちます。

解析された日付を timestamp フィールドに initial_date フィールドに基づいて追加する例を以下に示します:

Js

  1. {
  2.   "description" : "...",
  3.   "processors" : [
  4.    {
  5.    "date" : {
  6.    "field" : "initial_date",
  7.    "target_field" : "timestamp",
  8.    "formats" : ["dd/MM/yyyy HH:mm:ss"],
  9.    "timezone" : "Europe/Amsterdam"
  10.    }
  11.    }
  12.   ]
  13. }

timezone と locale プロセッサパラメータはテンプレート化されています。これは、これらの値がドキュメント内のフィールドから抽出できることを意味します。以下の例では、取り込まれたドキュメント内の既存のフィールド my_timezone と my_locale からロケール/タイムゾーンの詳細を抽出する方法を示しています。

Js

  1. {
  2.   "description" : "...",
  3.   "processors" : [
  4.    {
  5.    "date" : {
  6.    "field" : "initial_date",
  7.    "target_field" : "timestamp",
  8.    "formats" : ["ISO8601"],
  9.    "timezone" : "{{{my_timezone}}}",
  10.    "locale" : "{{{my_locale}}}"
  11.    }
  12.    }
  13.   ]
  14. }