CnOps 智能运维与可观测社区
首页开源项目实践文章视频课程常见问答开发者工具STAROps 专题
导航菜单
首页开源项目实践文章视频课程常见问答开发者工具STAROps 专题

CnOps 智能运维与可观测社区

愿景

CnOps 智能运维与可观测社区是一个以"智能运维与可观测"为核心的开放、包容、分享的技术社区,旨在聚集运维专家、开发者和爱好者,共同探讨、学习和分享可观测最佳实践与最新技术,与众多技术社区合作互动,共同探讨交叉领域的技术挑战,推动可观测领域的创新与进步。

内容社区

  • 实践文章
  • 视频课程
  • 开源项目
  • 常见问答
  • 开发者工具

友情链接

  • Prometheus
  • Grafana Lab
  • OpenTelemetry
  • LoongCollector

关注我们

阿里云云原生公众号阿里云云原生
阿里云可观测公众号阿里云可观测

Copyright © 2026 CnOps 社区. All rights reserved.

首页/开源项目/LoongCollector/插件配置项基本原则
文档目录
开发环境代码风格数据模型(C++)数据模型(Golang)
开源插件开发引导
如何开发扩展Input插件如何开发扩展Processor插件如何开发扩展Aggregator插件如何开发扩展Flusher插件如何开发Extension插件如何开发外部私有插件如何自定义构建产物中默认包含的插件插件配置项基本原则

LoongCollector

插件配置项基本原则

1. key 拼写错误:等价于该 key 没有被配置,直接拒绝加载该参数 2. value 格式错误、取值错误:直接拒绝加载该参数 1. key 拼写错误:等价于该 key 没有被配置,使用默认值 2. value 格式错误、取值错误:使用默认值 1. key 不存在或者 key 取值为空:不进行过滤 2. value 有值但全部取值错误:使用默认值,一般不进行过滤 3. value...

插件配置项基本原则

必选参数的处理原则

  1. key 拼写错误:等价于该 key 没有被配置,直接拒绝加载该参数
  2. value 格式错误、取值错误:直接拒绝加载该参数

可选参数的处理原则

  1. key 拼写错误:等价于该 key 没有被配置,使用默认值
  2. value 格式错误、取值错误:使用默认值

过滤类参数的处理原则

过滤类参数出现错误的处理原则

白名单

  1. key 不存在或者 key 取值为空:不进行过滤
  2. value 有值但全部取值错误:使用默认值,一般不进行过滤
  3. value 有值且存在正确取值:使用正确取值作为白名单过滤参数

黑名单

  1. key 不存在或者 key 取值为空:不进行过滤
  2. value 有值但全部取值错误:使用默认值,一般不进行过滤
  3. value 有值且存在正确取值:使用正确取值作为黑名单过滤参数

过滤类参数的内外部作用关系

白名单

  1. 每一个列表过滤参数的内部:匹配到列表的每一个取值都被允许过滤通过,内部过滤条件之间是“或”的关系
  2. 多个列表过滤参数之间:只有在所有列表参数中都被允许过滤通过的取值才会最终通过,多个列表过滤参数之间是“且”的关系

黑名单

  1. 每一个列表过滤参数的内部:匹配到列表内的每一个取值都不允许被过滤通过,内部过滤条件之间是“或”的关系
  2. 多个列表过滤参数之间:在每个列表参数中不被允许过滤通过的取值最终都不会通过,多个列表过滤参数之间是“或”的关系

文章大纲