将 Grafana Agent Flow 迁移到 Grafana Alloy

本主题介绍如何在停机时间最短的情况下，将 Grafana Agent Flow 实时迁移到 Grafana Alloy。

注意
此过程仅适用于从 Grafana Agent Flow 安装到 Alloy 的实时迁移。
如果您想全新安装 Alloy，可以卸载 Grafana Agent Flow，然后安装 Alloy。

开始之前

默认情况下，您只能使用标记为“正式可用”的功能。

您可以在 run 中设置 --stability.level 标志来启用“实验性”和“公共预览”中的功能。

--storage.path 的默认值已从 data-agent/ 更改为 data-alloy/。
--server.http.memory-addr 的默认值已从 agent.internal:12345 更改为 alloy.internal:12345。
Alloy 报告的调试指标前缀为 alloy_，而不是 agent_。
“经典模块” module.file、module.git、module.http 和 module.string 已被移除，取而代之的是 import 配置块。
prometheus.exporter.vsphere 组件已被 otelcol.receiver.vcenter 组件取代。

Alloy 使用与 Grafana Agent Flow 相同的配置格式，但一些功能已被移除。

在迁移之前，修改您的 Grafana Agent Flow 配置，移除或替换任何不受支持的组件

Grafana Agent Flow 中的“经典模块”已被 v0.40 中引入的模块取代
- module.file 被 import.file 配置块取代。
- module.git 被 import.git 配置块取代。
- module.http 被 import.http 配置块取代。
- module.string 被 import.string 配置块取代。
prometheus.exporter.vsphere 被 otelcol.receiver.vcenter 组件取代。

遵循 Alloy 的安装说明，使用默认配置文件。配置文件将在后续步骤中进行自定义。

部署 Alloy 时，请注意以下设置

部署 Alloy 时，其拓扑结构应与 Grafana Agent Flow 相同。CPU 和存储限制应保持一致。
在 Grafana Agent Flow 中配置的自定义命令行标志应在您的 Alloy 安装中反映出来。
部署 Alloy 时可能需要在 run 中使用 --stability.level 标志来启用非稳定组件
- 如果您使用以下组件，请将 --stability.level 设置为 experimental
  - otelcol.receiver.vcenter
- 否则，可以省略 --stability.level 或将其设置为默认值 generally-available。
在 Kubernetes 上安装时，更新您的 values.yaml 文件，将 agent 键重命名为 alloy。
如果您将 Alloy 部署为集群
- 将实例数设置为与 Grafana Agent Flow 集群中的实例数相匹配。
- 在迁移完成之前，不要启用自动扩缩容。

通过将 Grafana Agent Flow 数据目录的内容复制到 Alloy 数据目录来迁移您的 Grafana Agent Flow 数据。

Linux 安装：将 /var/lib/grafana-agent-flow 的内容复制到 /var/lib/alloy/data。
macOS 安装：将 $(brew --prefix)/etc/grafana-agent-flow/data 的内容复制到 $(brew --prefix)/etc/alloy/data。
Windows 安装：将 %ProgramData%\Grafana Agent Flow\data 的内容复制到 %ProgramData%\GrafanaLabs\Alloy\data。
Docker：将挂载卷的内容复制到新目录，然后在运行 Alloy 时挂载该目录。
Kubernetes：使用 kubectl cp 将 Flow Pod 上数据目录的内容复制到 Alloy Pod 上的数据目录。
- 数据目录由 values.yaml 文件中的 agent.storagePath（默认 /tmp/agent）和 alloy.storagePath（默认 /tmp/alloy）字段确定。