Alloy 配置基础

Alloy 使用 River 配置语言，这是一种声明式配置语言。今天我们要学习：配置文件结构、Components 概念、以及 Pipelines 配置方法。

配置文件结构

Alloy 配置文件有什么基本结构呢？

第一个配置块：logging。 配置 Alloy 的日志级别和格式，可选配置块。比如

level = "info"

format = "logfmt"

第二个配置块：Components。 定义数据源、处理器、导出器，使用

component.type

prometheus.exporter.unix "default"

第三个配置块：Pipelines。 连接组件，定义数据流，使用

forward_to

targets

prometheus.scrape "default"

第四个配置块：配置块结构。 使用花括号

{}

配置示例：

• 日志配置：

  logging { level = "info", format = "logfmt" }

• 组件定义：

  prometheus.exporter.unix "default" { }

  。

  "default"

  是组件名称。
• 管道配置：

  prometheus.scrape "default" { targets = ..., forward_to = [...] }

  。

  targets

  指定数据源，

  forward_to

  指定数据去向。

配置结构图： Alloy 配置包括 logging（日志配置）、Components（组件定义）、Pipelines（管道配置），Components 包括 Receivers（接收器）、Processors（处理器）、Exporters（导出器），Pipelines 使用数据流（forward_to）连接组件。

理解这个结构很重要。

Components 概念

Components 是什么？ Components 是 Alloy 的核心概念。定义数据源（Receivers）、处理数据（Processors）、导出数据（Exporters）、模块化配置。

Components 有什么类型呢？

第一种类型：Receivers（接收器）。 接收数据，比如

prometheus.exporter.unix "default"

otelcol.receiver.otlp "default"

第二种类型：Processors（处理器）。 处理数据，比如

otelcol.processor.batch "default"

otelcol.processor.transform "default"

第三种类型：Exporters（导出器）。 导出数据，比如

prometheus.remote_write "local"

loki.write "local"

Components 关系： Receivers（接收器）→ Processors（处理器）→ Exporters（导出器）。这是一个完整的数据流。

Components 的优势：

• 模块化： 每个组件独立配置。易于维护和复用。
• 组合： 可以组合多个组件。创建复杂的数据流。
• 复用： 可以定义多个同类型组件。比如多个 Prometheus 导出器。

理解 Components 是掌握 Alloy 的关键。

Pipelines 配置

Pipelines 是什么？ Pipelines 用于连接 Components，定义数据流。连接 Receivers 和 Processors，连接 Processors 和 Exporters，定义数据流转路径。

如何配置 Pipelines 呢？

第一步：定义接收器。

otelcol.receiver.otlp "default"

第二步：定义处理器。

otelcol.processor.batch "default"

第三步：定义导出器。

prometheus.remote_write "local"

第四步：连接组件。 使用

output

forward_to

output

input

output

input

Pipeline 流程： Receiver（otlp）→ Processor（batch）→ Exporter（prometheus）→ Remote Write（Prometheus）。这是一个完整的数据流。

Pipeline 配置的注意事项：

• 数据流方向： 数据从 Receivers 流向 Exporters。
• 多路径支持： 可以配置多个数据路径。比如同时导出到 Prometheus 和 Loki。
• 类型匹配： 确保数据类型匹配。比如 metrics 流到 metrics 处理。

使用 Pipelines 可以定义清晰的数据流。

本节小结

在本节中，我们学习了 Alloy 配置基础：

第一个是配置文件结构。 logging、Components、Pipelines。理解配置文件结构很重要。

第二个是 Components。 Receivers、Processors、Exporters。Components 是 Alloy 的核心概念。

第三个是 Pipelines。 连接组件，定义数据流。使用 Pipelines 可以定义清晰的数据流。

第四个是 River 语言。 声明式配置，支持嵌套和表达式。River 语言易于理解和维护。

Alloy 配置总结： Alloy 配置包括 Components（Receivers/Processors/Exporters）、Pipelines（连接组件）、River 语言（声明式配置）。这些组合在一起，构成了强大的配置能力。

这就是 Alloy 配置基础。掌握这些基础知识，可以开始配置 Alloy 了。

在下一节，我们将学习配置 Alloy 接收 OpenTelemetry 信号。学习如何配置 OTLP Receiver。