processor_dict_map外掛程式的參數說明和配置樣本 - Simple Log Service

您在使用Logtail採集日誌時，可以使用processor_dict_map外掛程式進列欄位值對應。本文介紹processor_dict_map外掛程式的參數說明和配置樣本。

使用限制

文本日誌和容器標準輸出只支援表單配置方式，其餘輸入外掛程式只支援JSON配置方式。

當您需要使用Logtail外掛程式處理日誌時，您可以在建立或修改Logtail採集配置時，添加外掛程式配置。具體操作，請參見處理外掛程式概述。

配置處理器類型為欄位值對應處理，相關參數說明如下表所示。

參數	說明
原始欄位	原始欄位名。
結果欄位	映射後的結果欄位名。
映射字典	映射字典。設定鍵和值，將鍵映射到值上。映射字典較小時，可直接通過此參數完成設定。不需要提供本地的CSV字典檔案。重要當您設定了本地字典後，映射字典配置不生效。
本地字典	CSV格式的字典檔案。該CSV檔案的分隔字元為半形逗號（,），欄位參考資料表示為半形引號（"）。
進階參數>處理原始欄位缺失	選中該選項後，當原始日誌中缺失目標欄位時，將處理缺失欄位，即按照結果欄位填儲值中的值進行填充。
進階參數>映射字典最大大小	映射字典的最大大小。預設值為1000，即最多可儲存1000條映射規則。如果要限制外掛程式對伺服器記憶體的佔用，可調小該值。
進階參數>原Tlog方法	當映射後的欄位在原始日誌中已存在時的處理方式。 overwrite（預設值）：覆寫原欄位。 fill：不覆寫原欄位。

配置type為processor_dict_map，detail說明如下表所示。

參數	類型	是否必選	說明
SourceKey	String	是	原始欄位名。
MapDict	Map	否	映射字典。映射字典較小時，可直接通過此參數完成設定。不需要提供本地的CSV字典檔案。重要當您設定了DictFilePath參數後，MapDict參數中的配置不生效。
DictFilePath	String	否	CSV格式的字典檔案。該CSV檔案的分隔字元為半形逗號（,），欄位參考資料表示為半形引號（"）。
DestKey	String	否	映射後的欄位名。
HandleMissing	Boolean	否	當原始日誌中缺失目標欄位時，系統是否處理。 true：處理。系統將按照Missing參數中的值進行填充。 false（預設值）：不處理。
Missing	String	否	處理原始日誌中缺失的目標欄位時，設定對應的填儲值。預設值為`Unknown`。當配置HandleMissing為true時，該參數配置生效。
MaxDictSize	Int	否	映射字典的最大大小。預設值為1000，即最多可儲存1000條映射規則。如果要限制外掛程式對伺服器記憶體的佔用，可調小該值。
Mode	String	否	當映射後的欄位在原始日誌中已存在時的處理方式。 overwrite（預設值）：覆寫原欄位。 fill：不覆寫原欄位。