`convert` 命令

公开预览: 这是一个公开预览组件。公开预览组件可能会发生重大变更，并可能被具有相同用例的等效功能取代。必须将 stability.level 标志设置为 public-preview 或更低才能使用此组件。

convert 命令将支持的配置格式转换为 Alloy 配置格式。

用法

alloy convert [<FLAG> ...] <FILE_NAME>

替换以下内容

<FLAG>: 一个或多个定义命令输入和输出的标志。
<FILE_NAME>: Alloy 配置文件。

如果未提供 <FILE_NAME> 参数或 <FILE_NAME> 参数等于 -，convert 会转换标准输入的内容。否则，convert 会读取并转换由该参数指定的文件。

convert 命令有几个不同的可用标志。您可以使用 --output 标志将转换后的配置内容写入指定路径。您可以使用 --report 标志生成诊断报告。--bypass-errors 标志允许您绕过文件转换过程中生成的任何错误。

如果源配置语法不正确或无法转换为 Alloy 配置，命令将失败。

支持以下标志

--output, -o: 输出写入的文件路径和文件名。
--report, -r: 报告写入的文件路径和文件名。
--source-format, -f: 必需。源文件的格式。支持的格式：otelcol、prometheus、promtail、static。
--bypass-errors, -b: 启用转换时绕过错误。
--extra-args, e: 转换器使用的原始格式的额外参数。

默认值

Alloy 默认值按如下方式管理：

如果提供的源配置值与 Alloy 默认值匹配，则输出中省略该属性。
如果未提供的源配置默认值与 Alloy 默认值匹配，则输出中省略该属性。
如果未提供的源配置默认值与 Alloy 默认值不匹配，则输出中包含该默认值。

错误

错误被定义为转换过程中识别出的非关键问题，即使出现这些问题，仍然可以生成输出。您可以使用 --bypass-errors 标志来绕过这些错误。

OpenTelemetry Collector

您可以使用 --source-format=otelcol 将 OpenTelemetry Collector 的源配置转换为 Alloy 配置。

支持许多 OpenTelemetry Collector 组件。请查阅组件参考中的 otelcol.* 组件信息，了解关于可转换的 otelcol 组件的更多信息。如果源配置包含不支持的功能，将其转换为 Alloy 配置时将会收到错误。转换器还会针对可能需要您注意的配置选项发出警告。

有关详细的迁移指南，请参阅从 OpenTelemetry Collector 迁移到 Alloy。

Prometheus

使用 --source-format=prometheus 将 Prometheus v2.45 的源配置转换为 Alloy 配置。

这包括 Prometheus 功能，例如 scrape_config、relabel_config、metric_relabel_configs、remote_write 以及许多受支持的 *_sd_configs。源配置中不支持的功能会导致错误。

有关详细的迁移指南，请参阅从 Prometheus 迁移到 Alloy。

Promtail

使用 --source-format=promtail 将 Promtail v2.8.x 的源配置转换为 Alloy 配置。

几乎所有Promtail 功能都受支持，并可以转换为 Alloy 配置。

如果源配置中包含不支持的功能，将其转换为 Alloy 配置时将会收到错误。转换器还会针对可能需要您注意的配置选项发出警告。

有关详细的迁移指南，请参阅从 Promtail 迁移到 Alloy。

Static

使用 --source-format=static 将 Grafana Agent Static 配置转换为 Alloy 配置。

包含 --extra-args 以传递来自原始格式的额外命令行标志。例如，--extra-args="-enable-features=integrations-next" 将 Grafana Agent Static 的 integrations-next 配置转换为 Alloy 配置。您还可以使用 --extra-args="-config.expand-env" 扩展环境变量。您可以在每个标志之间用空格分隔，组合多个命令行标志，例如 --extra-args="-enable-features=integrations-next -config.expand-env"。

如果 Grafana Agent Static 模式的源配置中包含不支持的功能，将其转换为 Alloy 配置时将会收到错误。转换器还会针对可能需要您注意的配置选项发出警告。

有关详细的迁移指南，请参阅从 Grafana Agent Static 迁移到 Alloy。