文档文档

Telegraf

安装 Telegraf

此页面提供了安装、启动和配置 Telegraf 的说明。要安装 Telegraf，请执行以下操作：

要求

安装 Telegraf 包可能需要 root 或管理员权限才能成功完成。

网络

Telegraf 提供多个服务 输入插件，这些插件可能需要自定义端口。通过配置文件 (telegraf.conf) 修改端口映射。

对于 Linux 发行版，此文件位于默认安装的 /etc/telegraf。

对于 Windows 发行版，配置文件位于解压 Telegraf ZIP 存档的目录中。默认位置是 C:\InfluxData\telegraf。

NTP

Telegraf 使用主机上的本地时间（UTC）为数据分配时间戳。使用网络时间协议 (NTP) 在主机之间同步时间。如果主机的时钟未与 NTP 同步，则数据上的时间戳可能不准确。

下载并安装 Telegraf

建议：： 在打开和安装软件包以及下载的文件之前，使用 SHA 校验和验证和 GPG 签名验证来确保文件完整且真实。

SHA 校验和和 GPG 签名验证是互补的检查。

对于某些 Linux 平台，安装说明包括验证下载的软件包和二进制文件的步骤。

有关更多信息，请参阅以下内容：

使用 SHA-256 验证下载完整性

使用 GPG 验证文件完整性和真实性

Ubuntu & Debian RedHat & CentOS SLES & openSUSE FreeBSD/PC-BSD Linux 二进制文件 (AMD) Linux 二进制文件 (ARM) macOS Windows

Debian 和 Ubuntu 用户可以使用 apt-get 包管理器安装最新稳定版的 Telegraf。

从 InfluxData 存储库安装

运行以下使用 apt-get 的命令，从 InfluxData 存储库安装 Telegraf：

Ubuntu 20.04 LTS 及更高版本 Ubuntu 20.04 之前的版本

curl --silent --location -O https://repos.influxdata.com/influxdata-archive.key
gpg --show-keys --with-fingerprint --with-colons ./influxdata-archive.key 2>&1 \
| grep -q '^fpr:\+24C975CBA61A024EE1B631787C3D57159FC2F927:$' \
&& cat influxdata-archive.key \
| gpg --dearmor \
| sudo tee /etc/apt/keyrings/influxdata-archive.gpg > /dev/null \
&& echo 'deb [signed-by=/etc/apt/keyrings/influxdata-archive.gpg] https://repos.influxdata.com/debian stable main' \
| sudo tee /etc/apt/sources.list.d/influxdata.list
sudo apt-get update && sudo apt-get install telegraf
# influxdata-archive_compat.key GPG Fingerprint: 9D539D90D3328DC7D6C8D3B9D8FF8E1F7DF8B07E
curl --silent --location -O https://repos.influxdata.com/influxdata-archive_compat.key
gpg --show-keys --with-fingerprint --with-colons ./influxdata-archive_compat.key 2>&1 \
| grep -q '^fpr:\+9D539D90D3328DC7D6C8D3B9D8FF8E1F7DF8B07E:$' \
&& cat influxdata-archive_compat.key \
| gpg --dearmor \
| sudo tee /etc/apt/keyrings/influxdata-archive_compat.gpg > /dev/null
echo 'deb [signed-by=/etc/apt/keyrings/influxdata-archive_compat.gpg] https://repos.influxdata.com/debian stable main' \
| sudo tee /etc/apt/sources.list.d/influxdata.list
sudo apt-get update && sudo apt-get install telegraf

从 .deb 文件安装

要手动从 .deb 文件安装 Debian 包：

  1. 从 下载页面下载最新的 Telegraf .deb 发行版。

  2. 运行以下命令（确保为下载的文件提供正确的版本号）：

    sudo dpkg -i telegraf_1.37.0-1_amd64.deb

要了解如何手动从文件安装 RPM 包，请参阅 下载页面。

要使用 yum 包管理器安装最新稳定版的 Telegraf，请按照以下步骤操作：

  1. 在终端中，输入以下命令将 InfluxData 存储库添加到 yum 配置中：

    cat <<EOF | sudo tee /etc/yum.repos.d/influxdata.repo
[influxdata]
name = InfluxData Repository - Stable
baseurl = https://repos.influxdata.com/stable/$basearch/main
enabled = 1
gpgcheck = 1
gpgkey = file:///etc/pki/rpm-gpg/RPM-GPG-KEY-influxdata
EOF

  2. 输入以下命令从存储库安装 telegraf。

    sudo yum install telegraf

telegraf 配置文件安装在 /etc/telegraf/telegraf.conf。

openSUSE 构建服务提供 SUSE Linux 的 RPM 包。

要使用 zypper 包管理器安装最新稳定版的 Telegraf，请按照以下步骤操作：

  1. 在终端中，输入以下命令将 Go 存储库添加到 zypper 配置中：

    # add go repository
zypper ar -f obs://devel:languages:go/ go

  2. 输入以下命令安装 telegraf。

    # install latest telegraf
zypper in telegraf

Telegraf 是 FreeBSD 包系统的一部分。

要使用 pkg 包管理器安装最新稳定版的 Telegraf，请输入以下命令：

sudo pkg install telegraf

telegraf 配置文件安装在 /usr/local/etc/telegraf.conf。示例文件安装在 /usr/local/etc/telegraf.conf.sample。

从以下选项中选择，以安装 Linux AMD 的 Telegraf 二进制文件：

在 Linux AMD64 上下载并安装

curl -s --location -O \
https://dl.influxdata.com/telegraf/releases/telegraf-1.37.0_linux_amd64.tar.gz \
&& echo "21e781cc2352713e4eabf0931e3eeea640a2014850a33ea04f86b4dc288d6add  telegraf-1.37.0_linux_amd64.tar.gz" \
| sha256sum -c -

替换以下内容：

  • 21e781cc2352713e4eabf0931e3eeea640a2014850a33ea04f86b4dc288d6add：来自 下载页面的 SHA 校验和

从以下选项中选择，以安装 Linux ARM 的 Telegraf 二进制文件：

在 Linux ARMv8 上下载并安装

curl -s --location -O \
https://dl.influxdata.com/telegraf/releases/telegraf-1.37.0_linux_arm64.tar.gz \
&& echo "7782bbcf50e67e73229fd0703c532d733e4fa259aa4b246debd012421f65c969  telegraf-1.37.0_linux_arm64.tar.gz" \
| sha256sum -c -

替换以下内容：

  • 7782bbcf50e67e73229fd0703c532d733e4fa259aa4b246debd012421f65c969：来自 下载页面的 SHA 校验和

从以下选项中选择，以安装 macOS 的 Telegraf：

使用 Homebrew 安装

macOS 10.8 及更高版本的用户可以使用 Homebrew 包管理器安装 Telegraf。

Homebrew 安装的 telegraf 二进制文件与从 下载页面可用的 macOS .dmg 构建版本不同。

  • telegraf (Homebrew) 不是静态二进制文件。
  • telegraf (Homebrew) 可与 Telegraf CPU 插件配合使用（因为 Homebrew 支持 Cgo）。在 下载页面上可用的 .dmg 构建版本不支持 CPU 插件。

要使用 Homebrew 安装，请执行以下操作：

  1. 如果尚未安装，请按照说明安装 Homebrew 包管理器。

  2. 输入以下命令来更新 brew 并安装 Telegraf：

    brew update && brew install telegraf

    brew 安装 telegraf.conf 配置文件的路径取决于您的系统架构：

    • 基于 ARM（Apple Silicon）的系统： /opt/homebrew/etc/telegraf.conf
    • 基于 Intel（x86_64）的系统： /usr/local/etc/telegraf.conf

  3. 选择以下任一方法来启动 Telegraf 并开始收集和处理指标：

在终端中运行 Telegraf

要在终端中运行 telegraf（在前台运行，而不是作为服务），请输入以下命令：

ARM (Apple Silicon) x86_64 (Intel)

telegraf -config /opt/homebrew/etc/telegraf.conf
telegraf -config /usr/local/etc/telegraf.conf

将 Telegraf 作为后台服务运行

在终端中，输入以下命令将 telegraf 添加到系统的 LaunchAgents：

ARM (Apple Silicon) x86_64 (Intel)

ln -sfv /opt/homebrew/opt/telegraf/*.plist ~/Library/LaunchAgents
ln -sfv /usr/local/opt/telegraf/*.plist ~/Library/LaunchAgents

下次登录时，launchd 将启动 telegraf 服务。

要立即启动 telegraf 服务，请输入以下命令：

launchctl load ~/Library/LaunchAgents/homebrew.mxcl.telegraf.plist

下载并作为 Windows 服务运行 Telegraf

安装 Windows 服务需要管理员权限。要以管理员身份运行 PowerShell，请参阅 以管理员身份启动 PowerShell。

在管理员权限下的 PowerShell 中，执行以下操作：

  1. 使用以下命令下载 Telegraf Windows 二进制文件，并将其内容提取到 C:\Program Files\InfluxData\telegraf\：

    wget `
https://dl.influxdata.com/telegraf/releases/telegraf-1.37.0_windows_amd64.zip `
-UseBasicParsing `
-OutFile telegraf-1.37.0_windows_amd64.zip
Expand-Archive .\telegraf-1.37.0_windows_amd64.zip `
-DestinationPath 'C:\Program Files\InfluxData\telegraf\'

  2. 选择一个以下步骤，将您的 telegraf.exe 和 telegraf.conf 文件放置在 C:\Program Files\InfluxData\telegraf：

    • 将 telegraf.exe 和 telegraf.conf 文件从 C:\Program Files\InfluxData\telegraf\telegraf-1.37.0 移动到父目录 C:\Program Files\InfluxData\telegraf，例如：

      cd "C:\Program Files\InfluxData\telegraf";
mv .\telegraf-1.37.0\telegraf.* .

    • 或者，为 C:\Program Files\InfluxData\telegraf 创建一个 Windows 符号链接 (Symlink)，指向提取的目录。

其余说明假定 telegraf.exe 和 telegraf.conf 文件存储在 C:\Program Files\InfluxData\telegraf 中，或者您已创建 Symlink 指向此目录。

  1. 可选：启用一个插件以收集特定于 Windows 的指标，例如，取消注释 inputs.win_services 插件的配置行：

    ...
# # Input plugin to report Windows services info.
# # This plugin ONLY supports Windows
[[inputs.win_services]]
...

  2. 运行以下命令将 Telegraf 和配置安装为 Windows 服务。对于 --config 选项，传递 telegraf.conf 配置文件的绝对路径。

    .\telegraf.exe --service install `
--config "C:\Program Files\InfluxData\telegraf\telegraf.conf"

  3. 要测试安装是否成功，请输入以下命令：

    .\telegraf.exe `
--config C:\"Program Files"\InfluxData\telegraf\telegraf.conf --test

    当以测试模式运行时（使用 --test 标志），Telegraf 会运行一次，收集指标，将其输出到控制台，然后退出。它不会运行处理器、聚合器或输出插件。

  4. 要开始收集数据，请运行：

    .\telegraf.exe --service start

日志记录和故障排除

当 Telegraf 作为 Windows 服务运行时，Telegraf 会将消息记录到 Windows 事件日志。如果 Telegraf 服务启动失败，请通过选择 事件查看器→Windows 日志→应用程序 来查看错误日志。

Windows 服务命令

以下命令可用：

命令效果
telegraf.exe --service install安装 telegraf 作为服务
telegraf.exe --service uninstall移除 telegraf 服务
telegraf.exe --service start启动 telegraf 服务
telegraf.exe --service stop停止 telegraf 服务

生成配置文件

telegraf config 命令允许您从 Telegraf 的 插件列表生成配置文件。

创建具有默认输入和输出插件的配置文件

要生成启用默认输入和输出插件的配置文件，请在终端中输入以下命令：

Linux 和 macOS Windows

telegraf config > telegraf.conf
.\telegraf.exe config > telegraf.conf

创建具有特定输入和输出插件的配置文件

要生成仅包含特定插件设置的配置文件，请使用 --input-filter 和 --output-filter 选项来指定 输入插件和 输出插件，例如：

Linux 和 macOS Windows

telegraf \
--input-filter 
cpu
:
http
 \
--output-filter 
influxdb_v2
:
file
 \
config > telegraf.conf
.\telegraf.exe `
--input-filter 
cpu
:
http
 `
--output-filter 
influxdb_v2
:
file
 `
config > telegraf.conf

有关更高级的配置详细信息，请参阅 配置文档。

自定义编译 Telegraf

使用 Telegraf 自定义构建工具，仅使用您需要的插件编译 Telegraf，并减小 Telegraf 二进制文件的大小。

  1. 前提条件
  2. 构建自定义构建工具
  3. 运行自定义构建工具以创建 telegraf 二进制文件

前提条件

构建自定义构建工具

  1. 克隆 Telegraf 存储库，然后进入存储库目录，例如，在终端中输入以下命令：

    git clone https://github.com/influxdata/telegraf.git && cd ./telegraf

  2. 要构建 Telegraf 自定义构建工具，请输入以下命令：

    make build_tools

运行自定义构建工具以创建 telegraf 二进制文件

自定义构建工具将使用指定配置文件或目录中包含的插件来构建一个 telegraf 二进制文件。

运行 custom_builder 工具，并至少指定一个 --config 或 --config-directory 标志，以指定要从中构建的 Telegraf 配置文件。

  • --config：接受本地文件路径和 URL。
  • --config-dir：接受本地目录路径。

您可以包含多个 --config 和 --config-dir 标志。

示例

单个 Telegraf 配置
./tools/custom_builder/custom_builder --config /etc/telegraf.conf
单个 Telegraf 配置和 Telegraf 配置目录
./tools/custom_builder/custom_builder \
--config /etc/telegraf.conf \
--config-dir /etc/telegraf/telegraf.d
远程 Telegraf 配置
./tools/custom_builder/custom_builder \
--config http://url-to-remote-telegraf/telegraf.conf

成功构建后，您可以在 Telegraf 存储库的顶层找到定制的 telegraf 二进制文件。

更新您的自定义二进制文件

要向自定义 Telegraf 构建添加或删除插件，请编辑配置文件，然后 运行自定义构建工具以重新生成 Telegraf 二进制文件。

此页面是否有帮助？

感谢您的反馈！

© 2025 InfluxData, Inc.

您在哪里运行 InfluxDB？

选择您的 **InfluxDB Cloud 区域和集群** 或您的 **InfluxDB OSS URL**，我们将为您定制代码示例。识别您的 InfluxDB Cloud 集群。

  • InfluxDB Cloud
  • InfluxDB OSS 或 Enterprise
AWS

  • 美国西部（俄勒冈州）

GCP
Azure
默认
自定义

有关更多信息，请参阅 InfluxDB Cloud 区域 或 InfluxDB OSS URL。

感谢您的反馈！

让我们知道我们可以做得更好

谢谢！

不用了，谢谢

InfluxDB 3.8 新特性

InfluxDB 3.8 和 InfluxDB 3 Explorer 1.6 的主要增强功能。

查看博客文章

InfluxDB 3.8 现已适用于 Core 和 Enterprise 版本，同时发布了 InfluxDB 3 Explorer UI 的 1.6 版本。本次发布着重于操作成熟度，以及如何更轻松地部署、管理和可靠地运行 InfluxDB。

更多信息，请查看

InfluxDB Docker 的 latest 标签将指向 InfluxDB 3 Core

在 **2026 年 2 月 3 日**，InfluxDB Docker 镜像的 latest 标签将指向 InfluxDB 3 Core。为避免意外升级，请在您的 Docker 部署中使用特定的版本标签。

如果使用 Docker 来安装和运行 InfluxDB，latest 标签将指向 InfluxDB 3 Core。为避免意外升级，请在您的 Docker 部署中使用特定的版本标签。例如，如果使用 Docker 运行 InfluxDB v2，请将 latest 版本标签替换为 Docker pull 命令中的特定版本标签 — 例如

docker pull influxdb:2