全部产品
Search
文档中心

日志服务:重命名字段

更新时间:Oct 25, 2023

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

  • 参数配置
    配置typeprocessor_renamedetail说明如下表所示。
    参数类型是否必选说明
    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"