如何使用processor_rename外掛程式重新命名欄位 - Simple Log Service

您在使用Logtail採集日誌時，可以使用processor_rename外掛程式重新命名欄位。本文介紹processor_rename外掛程式的參數說明和配置樣本。

使用限制

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

功能入口

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

配置說明

重要

Logtail 0.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`	Boolean	否	日誌中無您所指定的原始欄位時，系統是否報錯。 true：報錯。 false（預設值）：不報錯。
`SourceKeys`	String數組	是	待重新命名的原始欄位。
`DestKeys`	String數組	是	重新命名後的欄位。

配置樣本

將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"