文档中心

添加字段插件

最近更新时间：2023.11.13 16:31:36

首次发布时间：2023.02.16 21:23:21

您可以使用 add_kvs 插件指定 LogCollector 在日志中添加字段。

说明

LogCollector V1.0.18 及后续版本支持 add_kvs 插件。如何查看 LogCollector 版本，请参考查看软件版本。
add_kvs 插件处理器支持在日志中添加运行 LogCollector 的宿主机或容器的环境变量字段。当希望添加环境变量字段时，字段名（key）可使用自定义名称，字段值（value）应设置为${ENV_NAME}，日志服务会自动读取环境变量名称填入 value。如果运行 LogCollector 的宿主机或容器没有该环境变量 ENV_NAME，此时 value 为空。

参数说明

名称	类型	是否必选	说明
fields	Map<String,Object>	是	待添加的字段名（key）和字段值（value）。键值对格式，支持添加多个字段。字段名不可重复、不可为空、且不支持英文句号（.）。
when	Object	否	插件的执行条件，仅当执行条件判断为 true 时，才执行此插件。详细说明请参考插件执行条件。

名称

类型

是否必选

说明

fields

Map<String,Object>

是

待添加的字段名（key）和字段值（value）。

键值对格式，支持添加多个字段。
字段名不可重复、不可为空、且不支持英文句号（.）。

when

Object

否

插件的执行条件，仅当执行条件判断为 true 时，才执行此插件。详细说明请参考插件执行条件。

配置示例

原始日志

[1] [Dec 15, 2012 1:42:43 AM] com.dev.log.LoggingExample main

Logcollector插件处理器配置

{
  "processors": [
    {
      "add_kvs": {
        "fields": {
          "name": "Jack",
          "path": "${PATH}",
          "cluster_id": "C02G64T1MD6R"
        }
      }
    }
  ]
}

处理结果

"__content__": "[1] [Dec 15, 2012 1:42:43 AM] com.dev.log.LoggingExample main"
"name": "Jack"
"path": "/Users/Jack/go/bin"
"cluster_id": "C02G64T1MD6R"

参数说明

配置示例

日志服务

添加字段插件

参数说明

配置示例