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"