安装 Telegraf

本页提供了安装、启动和配置 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 验证下载完整性

对于每个发布的二进制文件，InfluxData 都会发布 SHA 校验和，您可以使用它来验证下载的文件是否完整且未损坏。

要使用 SHA 校验和验证下载的文件，请执行以下操作

在下载页面中，选择下载的版本和平台，然后复制文件的 SHA256 校验和。
计算下载文件的 SHA 校验和，并将其与上一步中复制的校验和进行比较 - 例如，在终端中输入以下命令。

语法

# Use 2 spaces to separate the checksum from the filename
echo "<SHA256_CHECKSUM>  telegraf-1.33.0_linux_amd64.tar.gz" \
| sha256sum -c -

替换以下内容

<SHA256_CHECKSUM>：从下载页面复制的 SHA256: 校验和值

示例

以下示例代码使用 curl 下载 Telegraf，然后使用 sha256 将其与校验和进行比较

curl -s --location -O \
"https://dl.influxdata.com/telegraf/releases/telegraf-${telegraf_latest_patches_v1}_linux_amd64.tar.gz"
echo "260bc3170dbd6cce67575c1215a0b89b8447945106e2943d74e617d06b750c03
  telegraf-${telegraf_latest_patches_v1}_linux_amd64.tar.gz" \
| sha256sum -c -

替换以下内容

260bc3170dbd6cce67575c1215a0b89b8447945106e2943d74e617d06b750c03：从下载页面复制的 SHA256: 校验和值

如果校验和匹配，则输出如下；否则，显示错误消息。

telegraf-1.33.0_linux_amd64.tar.gz: OK

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

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

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

从 InfluxData 存储库安装
从 .deb 文件安装

从 InfluxData 存储库安装

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

Ubuntu 20.04 LTS 及更高版本低于 Ubuntu 20.04 的版本

curl --silent --location -O \
https://repos.influxdata.com/influxdata-archive.key \
&& echo "943666881a1b8d9b849b74caebf02d3465d6beb716510d86a39f6c8e8dac7515  influxdata-archive.key" \
| sha256sum -c - && cat influxdata-archive.key \
| gpg --dearmor \
| sudo tee /etc/apt/trusted.gpg.d/influxdata-archive.gpg > /dev/null \
&& echo 'deb [signed-by=/etc/apt/trusted.gpg.d/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 \
&& echo "393e8779c89ac8d958f81f942f9ad7fb82a25e133faddaf92e15b16e6ac9ce4c  influxdata-archive_compat.key" \
| sha256sum -c - \
&& cat influxdata-archive_compat.key \
| gpg --dearmor \
| sudo tee /etc/apt/trusted.gpg.d/influxdata-archive_compat.gpg > /dev/null
echo 'deb [signed-by=/etc/apt/trusted.gpg.d/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 软件包

从下载页面下载最新的 Telegraf .deb 版本。
运行以下命令（确保为下载的文件提供正确的版本号）
```
sudo dpkg -i telegraf_1.33.0-1_amd64.deb
```

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

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

在您的终端中，输入以下命令将 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

输入以下命令以从存储库安装 telegraf。
```
sudo yum install telegraf
```

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

openSUSE Build Service 为 SUSE Linux 提供 RPM 软件包。

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

在您的终端中，输入以下命令将 Go 存储库添加到 zypper 配置中
```
# add go repository
zypper ar -f obs://devel:languages:go/ go
```

输入以下命令以安装 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 AMD32 上安装，请参阅下载页面。
在 Linux AMD64 上下载并安装

在 Linux AMD64 上下载并安装

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

替换以下内容

260bc3170dbd6cce67575c1215a0b89b8447945106e2943d74e617d06b750c03：来自下载页面的 SHA 校验和

从以下选项中选择以安装适用于 Linux ARM 的 Telegraf 二进制文件

要在 Linux ARMv7(32 位) 上安装，请参阅下载页面。
在 Linux ARMv8 (64 位) 上下载并安装

在 Linux ARMv8 上下载并安装

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

替换以下内容

f0d8ccae539afa04b171d5268dbab21eef58bc51b5437689e347619e2097c824：来自下载页面的 SHA 校验和

从以下选项中选择以安装适用于 macOS 的 Telegraf

要从文件手动安装 Telegraf，请参阅下载页面。
使用 Homebrew 安装

使用 Homebrew 安装

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

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

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

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

如果您尚未安装，请按照说明安装 Homebrew 软件包管理器。
输入以下命令以更新 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
选择以下方法之一来启动 Telegraf 并开始收集和处理指标
- 在终端中运行 Telegraf
- 以服务形式运行 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 中，执行以下操作

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

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

选择以下步骤之一，将 telegraf.exe 和 telegraf.conf 文件放置在 C:\Program Files\InfluxData\telegraf 中
- 将 telegraf.exe 和 telegraf.conf 文件从 C:\Program Files\InfluxData\telegraf\telegraf-1.33.0 移动到父目录 C:\Program Files\InfluxData\telegraf - 例如
```
cd "C:\Program Files\InfluxData\telegraf";
mv .\telegraf-1.33.0\telegraf.* .
```
- 或者，为 C:\Program Files\InfluxData\telegraf 创建一个 Windows 符号链接 (Symlink)，该链接指向提取的目录。

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

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

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

运行以下命令以安装 Telegraf 和配置作为 Windows 服务。对于 --config 选项，传递 telegraf.conf 配置文件的绝对路径。
```
.\telegraf.exe --service install `
--config "C:\Program Files\InfluxData\telegraf\telegraf.conf"
```
要测试安装是否有效，请输入以下命令
```
.\telegraf.exe `
--config C:\"Program Files"\InfluxData\telegraf\telegraf.conf --test
```
在测试模式下运行（使用 --test 标志）时，Telegraf 运行一次，收集指标，将其输出到控制台，然后退出。它不运行处理器、聚合器或输出插件。
要开始收集数据，请运行
```
.\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 二进制文件大小。

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

先决条件

按照说明为您的系统安装 Go。
创建您的 Telegraf 配置文件，其中包含您要使用的插件。

构建自定义构建器工具

克隆 Telegraf 存储库，然后更改到存储库目录 - 例如，在终端中输入以下命令
```
git clone https://github.com/influxdata/telegraf.git && cd ./telegraf
```
要构建 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 二进制文件。

此页对您有帮助吗？

感谢您的反馈！

支持和反馈

感谢您成为我们社区的一份子！我们欢迎并鼓励您提供关于 Telegraf 和本文档的反馈和错误报告。要获得支持，请使用以下资源

拥有年度合同或支持合同的客户可以联系 InfluxData 支持。

编辑此页提交文档问题提交 Telegraf 问题

安装 Telegraf

要求

网络

NTP

下载并安装 Telegraf

语法

示例

从 InfluxData 存储库安装

从 `.deb` 文件安装

在 Linux AMD64 上下载并安装

在 Linux ARMv8 上下载并安装

使用 Homebrew 安装

在终端中运行 Telegraf

以后台服务形式运行 Telegraf

下载并以 Windows 服务形式运行 Telegraf

日志记录和故障排除

Windows 服务命令

生成配置文件

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

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

自定义编译 Telegraf

先决条件

构建自定义构建器工具

运行自定义构建器以创建 `telegraf` 二进制文件

示例

单个 Telegraf 配置

单个 Telegraf 配置和 Telegraf 配置目录

远程 Telegraf 配置

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

支持和反馈

Flux 的未来

InfluxDB 3 开源版本现已发布公开 Alpha 版

安装 Telegraf

要求

网络

NTP

下载并安装 Telegraf

语法

示例

从 InfluxData 存储库安装

从 .deb 文件安装

在 Linux AMD64 上下载并安装

在 Linux ARMv8 上下载并安装

使用 Homebrew 安装

在终端中运行 Telegraf

以后台服务形式运行 Telegraf

下载并以 Windows 服务形式运行 Telegraf

日志记录和故障排除

Windows 服务命令

生成配置文件

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

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

自定义编译 Telegraf

先决条件

构建自定义构建器工具

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

示例

单个 Telegraf 配置

单个 Telegraf 配置和 Telegraf 配置目录

远程 Telegraf 配置

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

支持和反馈

您在哪里运行 InfluxDB？

AWS

GCP

Azure

默认

自定义

感谢您的反馈！

Flux 的未来

InfluxDB 3 开源版本现已发布公开 Alpha 版

从 `.deb` 文件安装

运行自定义构建器以创建 `telegraf` 二进制文件