loongcollector / project-knowledge

---
description: LoongCollector 采集配置常见陷阱。编写或审查 pipeline config YAML 时参考。
globs: 
  - "**/*.feature"
  - "**/case.feature"
  - "core/config/**"
  - "test/e2e/**"
alwaysApply: false
---
# LoongCollector 采集配置陷阱

## ExcutionTimeout 使配置变为一次性（onetime）

`global.ExcutionTimeout` 存在于配置中时，**整个配置**被标记为 onetime 类型。
只有注册了 `RegisterOnetimeInputCreator` 的插件才能在 onetime 配置中使用。

大部分输入插件（`input_forward`, `input_file`, `input_container_stdio`, `input_prometheus` 等）只注册了 `RegisterContinuousInputCreator`，在 onetime 配置中会报错：

```
failed to parse config:unsupported input plugin	module:input_forward
```

### 判断逻辑

```
global.ExcutionTimeout 存在
  → PipelineConfig::GetExpireTimeIfOneTime → mOnetimeExpireTime 被设置
    → CollectionConfig::IsOnetime() == true
      → IsValidNativeInputPlugin(name, true) 在 ONETIME 注册表查找
        → 找不到 → "unsupported input plugin"
```

### 支持 onetime 的输入插件

查看 `PluginRegistry::LoadStaticPlugins()` 中调用 `RegisterOnetimeInputCreator` 的插件，如 `InputStaticFile`。

### 规则

- **持续运行的输入插件配置中不要使用 `ExcutionTimeout`**
- E2E 测试不需要 `ExcutionTimeout` 来控制超时，Go test 的 `-timeout` 参数已经提供了保护
- 如果确实需要一次性采集，使用 `onetime_pipeline_config` 目录 + 支持 onetime 的输入插件

More agent context in alibaba/loongcollector

35 other files this repository gives its agents.