Logtailを使用してログを収集する場合、processor_dict_mapプラグインを使用してフィールド値をマッピングできます。 このトピックでは、processor_dict_mapプラグインのパラメーターについて説明します。 このトピックでは、プラグインの設定方法の例も示します。
制限事項
テキストログとコンテナーstdoutおよびstderrの入力プラグインは、フォーム設定のみをサポートしています。 その他の入力プラグインは、JSONでのエディター設定のみをサポートします。
エントリーポイント
Logtailプラグインを使用してログを処理する場合は、Logtail設定を作成または変更するときにLogtailプラグイン設定を追加できます。 詳細については、「データ処理用Logtailプラグインの概要」をご参照ください。
使用上の注意
フォーム設定
[プロセッサタイプ] パラメーターを [フィールド値マッピング] に設定します。 下表に、各パラメーターを説明します。
パラメーター | 説明 |
元のフィールド | 元のフィールドの名前。 |
新しいフィールド | マップされた値が割り当てられる新しいフィールドの名前。 |
マッピング辞書 | マッピング辞書。 ディクショナリに1つ以上のキーと値のペアを指定できます。 指定された辞書キーは、元のフィールドの値にマッピングされます。 マッピングするディクショナリのサイズが小さい場合は、このパラメーターを使用してディクショナリを構成できます。 ローカルのCSV形式の辞書ファイルを指定する必要はありません。 重要 Local Dictionaryパラメーターを設定した場合、Mapping Dictionaryパラメーターの設定は有効になりません。 |
ローカル辞書 | CSV形式の辞書ファイル。 |
高度なパラメータ> プロセス欠落元フィールド | このオプションを選択し、指定された元のフィールドが生のログに存在しない場合、[新しいフィールドを埋める値] パラメーターの値が新しいフィールドの値として使用されます。 |
高度なパラメータ> 最大マッピング辞書サイズ | マッピングディクショナリの最大サイズ。 デフォルト値は 1000 です。 この値は、最大1,000個のマッピングルールを格納できることを示します。 プラグインのサーバーメモリ使用量を制限するには、このパラメーターを小さい値に設定します。 |
高度なパラメータ> Rawログの処理方法 | 生ログ内の既存のフィールドを処理するために使用されるメソッド。 有効な値：
|
JSONでのエディター設定
次の表に、typeパラメーターをprocessor_dict_mapに設定した場合に、detailパラメーターで設定できるパラメーターを示します。
パラメーター | データ型 | 必須 | 説明 |
SourceKey | String | はい | 元のフィールドの名前。 |
MapDict | 地図 | いいえ | マッピング辞書。 マッピングするディクショナリのサイズが小さい場合は、このパラメーターを使用してディクショナリを構成できます。 ローカルのCSV形式の辞書ファイルを指定する必要はありません。 重要 DictFilePathパラメーターを設定した場合、MapDictパラメーターの設定は有効になりません。 |
DictFilePath | String | いいえ | CSV形式の辞書ファイル。 |
DestKey | String | いいえ | マップされた値が割り当てられる新しいフィールドの名前。 |
HandleMissing | ブール値 | いいえ | 指定された元のフィールドがログに存在しない場合、生のログを処理するかどうかを指定します。 有効な値：
|
行方不明 | String | いいえ | 指定された元のフィールドが生のログに存在しない場合、このパラメーターの値が新しいフィールドの値として使用されます。 デフォルト値: このパラメーターは、HandleMissingパラメーターがtrueに設定されている場合にのみ有効です。 |
MaxDictSize | Int | いいえ | マッピングディクショナリの最大サイズ。 デフォルト値は 1000 です。 この値は、最大1,000個のマッピングルールを格納できることを示します。 プラグインのサーバーメモリ使用量を制限するには、このパラメーターを小さい値に設定します。 |
モード | String | いいえ | 生ログ内の既存のフィールドを処理するために使用されるメソッド。 有効な値：
|