用途:本技能聚焦 OpenTelemetry Collector 单个组件的配置面,面向 opentelemetry-collector 与 opentelemetry-collector-contrib。不覆盖 OTTL 表达式、声明式 SDK 配置、eBPF profiler 等 profiles 生产者,也不涉及端到端流水线设计。
主要能力:按组件类型提供精简 README(元数据、描述、主要用例与 Details 索引),并按需展开 configuration.md(带版本的键、默认值、校验)、quirks.md(稳定性、可用性、失败行为、迁移陷阱)、verification.md 与 advanced.md。组件索引涵盖 log_dedup、interval、tail_sampling、redaction、filter、transform、attributes、resource、k8s_attributes、memory_limiter、load_balancing、otlp 收发、file_log、file_storage、prometheus 系列等,并标注类型、信号与稳定性。
使用方式:先在用户配置或问题中定位组件类型;若在索引中,先读 components/<type>/README.md,再按其 Details 索引深入最小相关文件,不要凭记忆推断配置键。未收录的组件应明确说明,并回退到上游 README(processor/<name>/、receiver/<name>/ 等)。应用 Collector 级约定:type/name 命名实例、稳定性级别、流水线放置规则(如 memory_limiter 置于处理器列表首位)。验证可用 telemetrygen 加 debug 或 file exporter 运行组件页的验证配方;contrib/k8s 发行版可用 otelcol-contrib --config <file>.yaml,不在发行版中的组件需先用 OCB 构建自定义 Collector。
适用场景与限制:适合编写、审查或调试 Collector YAML,判断组件生产可用性与重命名(v0.146.0 起多数组件改为 snake_case,旧名为弃用别名)。Alpha 与 Development 级组件常见且跨版本行为会变。验证配方为最小复现,省略了 memory_limiter 等生产脚手架,不可原样用于生产。