全部产品
Search
文档中心

日志服务:打包字段

更新时间:Oct 25, 2023

您在使用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说明如下表所示。
    参数类型是否必选说明
    SourceKeysString数组待打包的原始字段。
    DestKeyString打包后的字段。
    KeepSourceBoolean解析后的日志中是否保留原始字段。
    • true(默认值):保留。
    • false:不保留。
    AlarmIfIncompleteBoolean原始日志中无您所指定的原始字段时,系统是否报错。
    • 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\"}"