如何通过processor_add_fields插件添加日志字段_日志服务(SLS)-阿里云帮助中心

您在使用Logtail采集日志时，可以使用processor_add_fields插件添加日志字段。本文介绍processor_add_fields插件的参数说明和配置示例。

使用限制

文本日志和容器标准输出只支持表单配置方式，其余输入插件只支持JSON配置方式。

功能入口

当您需要使用Logtail插件处理日志时，您可以在创建或修改Logtail采集配置时，添加插件配置。具体操作，请参见概述。

配置说明

重要

Logtail 0.16.28及以上版本支持processor_add_fields插件。

表单配置方式

参数说明
配置处理器类型为添加字段，相关参数说明如下表所示。
参数
说明
添加字段
待添加的字段名和字段值，支持添加多个。
忽略重复字段
存在相同的字段名时，是否忽略重复的字段。
配置示例
添加aaa2字段和aaa3字段，配置示例如下：
- 原始日志
```
"aaa1":"value1"
```
- Logtail插件处理配置
- 处理结果
```
"aaa1":"value1"
"aaa2":"value2"
"aaa3":"value3"
```

JSON配置方式

参数说明

配置type为processor_add_fields，detail说明如下表所示。

参数

类型

是否必选

说明

Fields

Map

是

待添加的字段名和字段值。键值对格式，支持添加多个。

IgnoreIfExist

Boolean

否

存在相同的字段名时，是否忽略重复的字段。

true：忽略。
false（默认值）：不忽略。

配置示例

添加aaa2字段和aaa3字段，配置示例如下：

原始日志
```
"aaa1":"value1"
```

Logtail插件处理配置

{
  "processors":[
    {
      "type":"processor_add_fields",
      "detail": {
        "Fields": {
          "aaa2": "value2",
          "aaa3": "value3"
        }
      }
    }
  ]
}

处理结果

"aaa1":"value1"
"aaa2":"value2"
"aaa3":"value3"

参数	说明
添加字段	待添加的字段名和字段值，支持添加多个。
忽略重复字段	存在相同的字段名时，是否忽略重复的字段。