安装 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: 你从下载页面复制的校验和值

示例

以下示例代码使用 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构建服务为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 (苹果硅) x86_64 (英特尔)

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

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

作为后台服务运行Telegraf

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

ARM (苹果硅) x86_64 (英特尔)

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.* .
```
- 或者，为Windows符号链接（Symlink）创建一个指向提取目录的C:\Program Files\InfluxData\telegraf。

剩余的指令假设 telegraf.exe 和 telegraf.conf 文件存储在 C:\Program Files\InfluxData\telegraf 或者你创建了一个符号链接指向这个目录。

可选：启用一个插件来收集特定于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 二进制文件

先决条件

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

构建自定义构建工具

克隆 Telegraf 仓库，然后切换到该仓库目录—例如，在您的终端中输入以下命令：
```
git clone https://github.com/influxdata/telegraf.git && cd ./telegraf
```
要构建 Telegraf 自定义构建工具，请输入以下命令：
```
make build_tools
```

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

自定义构建器构建一个 telegraf 二进制文件，仅包含指定配置文件或目录中包含的插件。

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

--config: 接受本地文件路径和网址。
--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

要求

网络

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

谷歌云平台

微软 Azure

默认

自定义

感谢您的反馈!

Flux的未来

InfluxDB 3 开源版本现已公开Alpha测试

从 `.deb` 文件安装

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