文档 Grafana Alloy 设置 运行 独立运行

将 Grafana Alloy 作为独立二进制文件运行

如果您下载了独立二进制文件，则必须从终端或命令行窗口运行 Alloy。

请参考运行文档，了解更多关于运行 Alloy 时可以使用的命令行标志信息。

启动 Alloy

要启动 Alloy，请在终端或命令行窗口中运行以下命令

shell 复制

<BINARY_PATH> run <CONFIG_PATH>

替换以下内容

• <BINARY_PATH>: Alloy 二进制文件的路径。
• <CONFIG_PATH>: Alloy 配置文件的路径。

将 Alloy 设置为 Linux systemd 服务

您可以将 Alloy 的独立二进制文件设置为 Linux systemd 服务并进行管理。

1. 要创建名为 alloy 的用户，请在终端窗口中运行以下命令

   shell 复制

   sudo useradd --no-create-home --shell /bin/false alloy

2. 在 /etc/systemd/system 中创建名为 alloy.service 的服务文件，内容如下

   systemd 复制

   [Unit]
   Description=Vendor-neutral programmable observability pipelines.
   Documentation=https://grafana.org.cn/docs/alloy/
   Wants=network-online.target
   After=network-online.target
   
   [Service]
   Restart=always
   User=alloy
   Environment=HOSTNAME=%H
   EnvironmentFile=/etc/default/alloy
   WorkingDirectory=<WORKING_DIRECTORY>
   ExecStart=<BINARY_PATH> run $CUSTOM_ARGS --storage.path=<WORKING_DIRECTORY> $CONFIG_FILE
   ExecReload=/usr/bin/env kill -HUP $MAINPID
   TimeoutStopSec=20s
   SendSIGKILL=no
   
   [Install]
   WantedBy=multi-user.target

   替换以下内容

   • <BINARY_PATH>: Alloy 二进制文件的路径。
   • <WORKING_DIRECTORY>: 工作目录的路径，例如 /var/lib/alloy。

3. 在 /etc/default/ 中创建名为 alloy 的环境文件，内容如下

   shell 复制

   ## Path:
   ## Description: Grafana Alloy settings
   ## Type:        string
   ## Default:     ""
   ## ServiceRestart: alloy
   #
   # Command line options for alloy
   #
   # The configuration file holding the Grafana Alloy configuration.
   CONFIG_FILE="<CONFIG_PATH>"
   
   # User-defined arguments to pass to the run command.
   CUSTOM_ARGS=""
   
   # Restart on system upgrade. Defaults to true.
   RESTART_ON_UPGRADE=true

   替换以下内容

   • <CONFIG_PATH>: Alloy 配置文件的路径。

4. 要重新加载服务文件，请在终端窗口中运行以下命令

   shell 复制

   sudo systemctl daemon-reload

5. 使用Linux systemd 命令管理您的独立 Linux Alloy 安装。

查看 Alloy 日志

默认情况下，Alloy 将输出写入 stdout，错误写入 stderr。

要将输出和错误日志写入文件，您可以使用操作系统的重定向运算符。例如，以下命令将标准输出和标准错误合并到一个文本文件中

linuxmacoswindows

复制

linux 复制

<BINARY_PATH> run <CONFIG_PATH> &> <OUTPUT_FILE>

macos 复制

<BINARY_PATH> run <CONFIG_PATH> &> <OUTPUT_FILE>

windows 复制

<BINARY_PATH> run <CONFIG_PATH> 1> <OUTPUT_FILE> 2>&1

替换以下内容

• <BINARY_PATH>: Alloy 二进制文件的路径。
• <CONFIG_PATH>: Alloy 配置文件的路径。
• <OUTPUT_FILE>: 输出文件名。