菜单
文档breadcrumb arrow Grafana Alloybreadcrumb arrow 设置breadcrumb arrow 安装breadcrumb arrow Windows
开源

在 Windows 上安装 Grafana Alloy

你可以在 Windows 上以标准图形化方式安装 Alloy，也可以进行静默安装。

标准图形化安装

要在 Windows 上进行 Alloy 的标准图形化安装，请执行以下步骤。

  1. 导航到 GitHub 上的最新版本。

  2. 向下滚动到Assets（资产）部分。

  3. 下载名为 alloy-installer-windows-amd64.exe.zip 的文件。

  4. 提取下载的文件。

  5. 双击 alloy-installer-windows-amd64.exe 安装 Alloy。

Alloy 默认安装到目录 %PROGRAMFILES64%\GrafanaLabs\Alloy。

静默安装

要在 Windows 上进行 Alloy 的静默安装，请执行以下步骤。

  1. 导航到 GitHub 上的最新版本。

  2. 向下滚动到Assets（资产）部分。

  3. 下载名为 alloy-installer-windows-amd64.exe.zip 的文件。

  4. 提取下载的文件。

  5. 在 PowerShell 或命令提示符中运行以下命令

    cmd 
    <PATH_TO_INSTALLER> /S

    替换以下内容

    • <安装程序路径>：未压缩的安装程序可执行文件的路径。

静默安装选项

  • /CONFIG=<路径> 配置文件的路径。默认值：$INSTDIR\config.alloy
  • /DISABLEREPORTING=<yes|no> 禁用数据采集。默认值：no
  • /DISABLEPROFILING=<yes|no> 禁用性能分析端点。默认值：no
  • /ENVIRONMENT="KEY=VALUE\0KEY2=VALUE2" 为 Windows 服务定义环境变量。默认值：``
  • /RUNTIMEPRIORITY="normal|below_normal|above_normal|high|idle|realtime" 设置 Alloy 进程的运行时优先级。默认值：normal
  • /STABILITY="generally-available|public-preview|experimental" 设置 Alloy 的稳定性级别。默认值：generally-available
  • /USERNAME="<用户名>" 设置 Windows 用于运行服务的完全限定用户。默认值：NT AUTHORITY\LocalSystem
  • /PASSWORD="<密码>" 设置 Windows 用于运行服务的用户的密码。对于 LocalSystem 等标准 Windows 服务账户，此项非必需。默认值：``

注意

--windows.priority 标志处于Public preview 阶段，不受 Grafana Alloy 向后兼容性保证的覆盖。/RUNTIMEPRIORITY 安装选项会设置此标志，如果 Alloy 未以适当的稳定性级别运行，它将无法启动。

服务配置

Alloy 使用 Windows 注册表 HKLM\Software\GrafanaLabs\Alloy 进行服务配置。

  • Arguments（类型 REG_MULTI_SZ）每个值代表一个 alloy 二进制文件的参数。
  • Environment（类型 REG_MULTI_SZ）每个值代表一个 alloy 二进制文件的环境变量 KEY=VALUE。

卸载

你可以使用 Windows 的“添加或删除程序”或运行 %PROGRAMFILES64%\GrafanaLabs\Alloy\uninstaller.exe 来卸载 Alloy。卸载 Alloy 会停止服务并将其从磁盘中移除。这包括安装目录中的所有配置文件。

Alloy 也可以以管理员身份运行 uninstall.exe /S 进行静默卸载。

后续步骤