技能介绍

要解决的问题

OpenTelemetry Collector 发行版并不缺组件，缺的是把 receiver、processor、exporter 接成一条可用管道的结构化知识。Alloy 用 HCL 的组件模型描述管道，但手写配置时容易踩坑：信号类型和组件输入输出不匹配、批次处理参数缺失、端点端口配错，问题往往要到运行期才暴露。当 Agent 被要求代为生成或修改采集配置时，缺少一份能描述“管道该怎么接”的操作手册，产出的配置经常跑不起来。

技能如何工作

这份技能把 Alloy 的管道配置方式整理成 Agent 可以直接引用的模式，覆盖 metrics、logs、traces、profiles 四类信号。它的核心思路是按组件接线，而不是堆配置文本。

接收端使用 otelcol.receiver.otlp 一类组件，从 OTLP 端点收数据
数据通过声明式引用接入下游，例如 otelcol.processor.batch.example.input
输出、批处理、路由等环节继续用同一套组件语义拼接

资料提取自 Alloy 上游仓库的 README，说明这些模式与官方文档保持一致，Agent 可以据此回答“某类信号该接哪些组件”这类问题。

适用边界

资料里给出的片段是最小示例，只演示了接收与批处理的接线，没有覆盖 exporter 配置、采样策略和资源限额。真实环境里这些都要按集群规模和数据量单独评估。上游 Alloy 迭代较快，本技能中的写法可能落后于最新版本，遇到 otelcol.* 组件行为变化时应回到官方文档核对。Agent 在生成配置前，应先确认信号类型、暴露端点和网络可达性，否则产出的配置即使语法正确也无法实际采集数据。