如何使用processor_rename插件重命名字段 - 日志服务

您在使用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"