Edit Fields Processor

This product is not supported for your selected Datadog site. ().
利用可能な対象:

ログ

概要

Edit Fields プロセッサーは、個々のログデータ内のフィールドを追加、削除、または名前変更できます。このプロセッサーを使用して、ログにコンテキストを追加して情報を充実させたり、価値の低いフィールドを削除してデータ量を削減したり、重要な属性の名前を標準化したりできます。ドロップダウンメニューで add field、drop field、または rename field を選択して開始します。

Edit Fields プロセッサーを使用して属性を再マッピングする方法については、Remap Reserved Attributes ガイドを参照してください。

セットアップ

フィールドを追加

add field を使用して、ログに新しいキーと値のペアを追加します。

add field プロセッサーの設定方法

  1. [filter query] (フィルタークエリ) を定義します。指定されたフィルタークエリに一致するログのみが処理されます。フィルタークエリに一致するかどうかにかかわらず、すべてのログがパイプラインの次のステップに送信されます。詳細については、検索構文を参照してください。
  2. 追加するフィールドと値を入力します。キーにネストされたフィールドを指定するには、パス表記を使用します: <OUTER_FIELD>.<INNER_FIELD>。すべての値は文字列として保存されます。 注: 追加するフィールドがすでに存在する場合、Worker はエラーをログに記録し、既存のフィールドは変更されません。

フィールドを削除

drop field を使用して、以下で指定するフィルターに一致するログデータからフィールドを削除します。オブジェクトを削除できるため、このプロセッサーを使用してネストされたキーを削除できます。

drop field プロセッサーの設定方法

  1. [filter query] (フィルタークエリ) を定義します。指定されたフィルタークエリに一致するログのみが処理されます。フィルタークエリに一致するかどうかにかかわらず、すべてのログがパイプラインの次のステップに送信されます。詳細については、検索構文を参照してください。
  2. 削除するフィールドのキーを入力します。指定したキーにネストされたフィールドを指定するには、パス表記を使用します: <OUTER_FIELD>.<INNER_FIELD>。 注: 指定したキーが存在しない場合、ログは変更されません。

フィールドをリネーム

rename fieldを使用して、ログ内のフィールド名を変更します。

rename field プロセッサーの設定方法

  1. [filter query] (フィルタークエリ) を定義します。指定されたフィルタークエリに一致するログのみが処理されます。フィルタークエリに一致するかどうかにかかわらず、すべてのログがパイプラインの次のステップに送信されます。詳細については、検索構文を参照してください。
  2. Source field でリネームするフィールドの名前を入力します。キーにネストされたフィールドを指定するには、パス表記を使用します: <OUTER_FIELD>.<INNER_FIELD>。リネーム後、以下で説明する Preserve source tag チェックボックスを有効にしない限り、元のフィールドは削除されます。
    注: 指定したソースキーが存在しない場合、ターゲットにはデフォルトの null 値が適用されます。
  3. Target field に、ソースフィールドの新しい名前を入力します。指定したキーにネストされたフィールドを指定するには、パス表記を使用します: <OUTER_FIELD>.<INNER_FIELD>。
    注: 指定したターゲットフィールドがすでに存在する場合、Worker はエラーをログに記録し、既存のターゲットフィールドを上書きしません。
  4. 必要に応じて、元のソースフィールドを保持し、ソースキーの情報を指定したターゲットキーにコピーする場合は、Preserve source tag ボックスをオンにします。このボックスをオンにしない場合、ソースキーはリネーム後に削除されます。

パス表記の例

For this log structure example:

{
    "outer_key": {
        "inner_key": "inner_value",
        "a": {
            "double_inner_key": "double_inner_value",
            "b": "b value"
        },
        "c": "c value"
    },
    "d": "d value"
}

Follow these reference rules:

  • Use outer_key.inner_key to reference the key with the value inner_value.
  • Use outer_key.a.double_inner_key to reference the key with the value double_inner_value.

To specify a nested field with a literal . in the attribute key, wrap the key in escaped quotes in the search query. For example, the search query "service.status":disabled matches the event {"service.status": "disabled"}.

健全性メトリクス

すべてのプロセッサーから出力されるコンポーネントメトリクスおよびプロセッサーバッファメトリクスについては、Pipelines 使用状況メトリクスのドキュメントを参照してください。Edit Fields プロセッサーのメトリクスでフィルタリングまたはグループ化するには、構成したアクションに応じて、タグ component_type:add_fields、component_type:remove_fields、または component_type:rename_fields を使用します。

参考資料

役立つドキュメント、リンク、記事:

予約済み属性の再マッピングドキュメント more more