すべてのプロダクト
Search
ドキュメントセンター

Simple Log Service:拡張プラグイン: フィールド名の変更

最終更新日:Apr 22, 2025

Logtail を使用してログを収集する場合、processor_rename プラグインを使用してフィールドの名前を変更できます。このトピックでは、processor_rename プラグインのパラメーターについて説明し、プラグインを構成する方法の例を示します。

制限事項

テキストログとコンテナーの標準出力および標準エラーの入力プラグインは、フォーム構成のみをサポートしています。その他の入力プラグインは、JSON でのエディター構成のみをサポートしています。

エントリポイント

Logtail プラグインを使用してログを処理する場合、Logtail 構成の作成時または変更時に Logtail プラグイン構成を追加できます。詳細については、「データ処理用の Logtail プラグインの概要」をご参照ください。

構成の説明

重要

Logtail V0.16.28 以降のみが processor_rename プラグインをサポートしています。

フォーム構成

  • パラメーター

    [プロセッサの種類] パラメーターを [フィールド名の変更] に設定します。次に、以下の表に基づいて他のパラメーターを構成します。

    パラメーター

    説明

    元のフィールド

    名前を変更する元のフィールド。

    新しいフィールド

    元のフィールドの新しい名前。

    元のフィールドが見つからないエラーを報告する

    生のログに元のフィールドが含まれていない場合にエラーを報告するかどうかを指定します。

  • 次の例は、aaa1 フィールドの名前を bbb1 に変更し、aaa2 フィールドの名前を bbb2 に変更する方法を示しています。

    • 生のログ

      "aaa1":"value1"
      "aaa2":"value2"
      "aaa3":"value3"
    • データ処理用の Logtail プラグイン構成Rename fields

    • 処理結果

      "bbb1":"value1"
      "bbb2":"value2"
      "aaa3":"value3"

JSON でのエディター構成

  • パラメーター

    type パラメーターを processor_rename に設定します。次に、以下の表に基づいて detail セクションで他のパラメーターを構成します。

    パラメーター

    タイプ

    必須

    説明

    NoKeyError

    ブール値

    いいえ

    生のログに元のフィールドが含まれていない場合にエラーを報告するかどうかを指定します。有効な値:

    • true

    • false (デフォルト)

    SourceKeys

    文字列配列

    はい

    名前を変更する元のフィールド。

    DestKeys

    文字列配列

    はい

    元のフィールドの新しい名前。

  • 次の例は、aaa1 フィールドの名前を bbb1 に変更し、aaa2 フィールドの名前を bbb2 に変更する方法を示しています。

    • 生のログ

      "aaa1":"value1"
      "aaa2":"value2"
      "aaa3":"value3"
    • データ処理用の Logtail プラグイン構成

      {
        "processors":[
          {
            "type":"processor_rename",
            "detail": {
              "SourceKeys": ["aaa1","aaa2"],
              "DestKeys": ["bbb1","bbb2"],
              "NoKeyError": true // 元のキーが存在しない場合にエラーを報告するかどうか
            }
          }
        ]
      }
    • 処理結果

      "bbb1":"value1"
      "bbb2":"value2"
      "aaa3":"value3"