您在使用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说明如下表所示。参数
类型
是否必选
说明
NoKeyErrorBoolean
否
日志中无您所指定的原始字段时，系统是否报错。
true：报错。
false（默认值）：不报错。
SourceKeysString数组
是
待重命名的原始字段。
DestKeysString数组
是
重命名后的字段。
配置示例
将
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"