processor_rename プラグインを使用してフィールドの名前を変更する方法 - Simple Log Service

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 プラグイン構成
- 処理結果
```
"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"