全部产品
Search
文档中心

日志服务:打包字段

更新时间:Apr 26, 2024

您在使用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配置方式

  • 参数说明

    配置typeprocessor_packjsondetail说明如下表所示。

    参数

    类型

    是否必选

    说明

    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\"}"