如何使用processor_packjson插件打包字段 - 日志服务

您在使用Logtail采集日志时，可以使用processor_packjson插件将一个或多个字段打包为JSON Object格式的字段。本文介绍processor_packjson插件的参数说明和配置示例。

使用限制

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

功能入口

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

配置说明

重要

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

表单配置方式

参数说明

配置处理器类型为打包字段，相关参数说明如下表所示。

参数	说明
原始字段	待打包的原始字段。
结果字段	打包后的字段。
保留原始字段	选中该选项后，解析后的日志中将保留原始字段。
原始字段缺失报错	选中该选项后，如果原始日志中无您指定的原始字段，系统将报错。

配置示例
将指定的a字段和b字段打包成JSON字段d_key，配置示例如下：
- 原始日志
```
"a":"1"
"b":"2"
```
- Logtail插件处理配置
- 处理结果
```
"a":"1"
"b":"2"
"d_key":"{\"a\":\"1\",\"b\":\"2\"}"
```

JSON配置方式

参数说明

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

参数	类型	是否必选	说明
SourceKeys	String数组	是	待打包的原始字段。
DestKey	String	否	打包后的字段。
KeepSource	Boolean	否	解析后的日志中是否保留原始字段。 true（默认值）：保留。 false：不保留。
AlarmIfIncomplete	Boolean	否	原始日志中无您所指定的原始字段时，系统是否报错。 true（默认值）：报错。 false：不报错。

配置示例

将指定的a字段和b字段打包成JSON字段d_key，配置示例如下：

原始日志
```
"a":"1"
"b":"2"
```

Logtail插件处理配置

{
  "processors":[
    {
      "type":"processor_packjson",
      "detail": {
        "SourceKeys": ["a","b"],
        "DestKey":"d_key",
        "KeepSource":true,
        "AlarmIfEmpty":true
      }
    }
  ]
}

处理结果

"a":"1"
"b":"2"
"d_key":"{\"a\":\"1\",\"b\":\"2\"}"