全部產品
Search
文件中心

Simple Log Service:欄位值對應處理

更新時間:Jul 30, 2024

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

使用限制

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

功能入口

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

配置說明

表單配置方式

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

參數

說明

原始欄位

原始欄位名。

結果欄位

映射後的結果欄位名。

映射字典

映射字典。設定鍵和值,將鍵映射到值上。

映射字典較小時,可直接通過此參數完成設定。不需要提供本地的CSV字典檔案。

重要

當您設定了本地字典後,映射字典配置不生效。

本地字典

CSV格式的字典檔案。該CSV檔案的分隔字元為半形逗號(,),欄位參考資料表示為半形引號(")。

進階參數>處理原始欄位缺失

選中該選項後,當原始日誌中缺失目標欄位時,將處理缺失欄位,即按照結果欄位填儲值中的值進行填充。

進階參數>映射字典最大大小

映射字典的最大大小。預設值為1000,即最多可儲存1000條映射規則。

如果要限制外掛程式對伺服器記憶體的佔用,可調小該值。

進階參數>原Tlog方法

當映射後的欄位在原始日誌中已存在時的處理方式。

  • overwrite(預設值):覆寫原欄位。

  • fill:不覆寫原欄位。

JSON配置方式

配置typeprocessor_dict_mapdetail說明如下表所示。

參數

類型

是否必選

說明

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:不覆寫原欄位。