Ubuntu 和 Debian
使用以下命令从 InfluxData 存储库安装 Telegraf:
# influxdb.key GPG Fingerprint: 05CE15085FC09D18E99EFB22684A14CF2582E0C5
wget -q https://repos.influxdata.com/influxdb.key
echo '23a1c8836f0afc5ed24e0486339d7cc8f6790b83886c4c96995b88a061c5bb5d influxdb.key' | sha256sum -c && cat influxdb.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/influxdb.gpg > /dev/null
echo 'deb [signed-by=/etc/apt/trusted.gpg.d/influxdb.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 软件包:
从下载页面
.deb
的 Telegraf 部分下载最新的 Telegraf版本。运行以下命令(确保为下载的文件提供正确的版本号):
sudo dpkg -i telegraf_1.23.0-1_amd64.deb
配置Telegraf
定义 Telegraf 将在配置文件中使用哪些插件。每个配置文件都需要至少一个启用的输入插件(指标来自哪里)和至少一个启用的输出插件(指标去哪里)。
以下示例生成包含所有可用插件的示例配置文件,然后使用filter
标志启用特定插件。
有关filter
其他标志的详细信息,请参阅Telegraf 命令和标志。
运行以下命令创建配置文件:
telegraf --sample-config > telegraf.conf
找到配置文件。位置因您的系统而异:
- macOS自制软件:
/usr/local/etc/telegraf.conf
- Linux debian 和 RPM 软件包:
/etc/telegraf/telegraf.conf
- 独立二进制文件:请参阅下一节了解如何创建配置文件
注意:您还可以指定一个远程 URL 端点以从中提取配置文件。请参阅配置文件位置。
- macOS自制软件:
vim
使用或 文本编辑器编辑配置文件。因为此示例使用InfluxDB V2 输出插件,我们需要将 InfluxDB URL、身份验证令牌、组织和存储桶详细信息添加到配置文件的这一部分。
注意:有关更多配置文件选项,请参阅配置选项。
- 对于此示例,使用标志指定两个输入 (
cpu
和mem
) 。--input-filter
将 InfluxDB 指定为带有--output-filter
标志的输出。
telegraf --sample-config --input-filter cpu:mem --output-filter influxdb_v2 > telegraf.conf
生成的配置将收集 CPU 和内存数据并将其发送到 InfluxDB V2。
设置环境变量
在配置文件的任何位置添加环境变量,方法是在它们前面加上$
. 对于字符串,变量必须用引号引起来(例如,"$STR_VAR"
)。对于数字和布尔值,变量必须不加引号(例如$INT_VAR
,, $BOOL_VAR
)。
您还可以使用 Linuxexport
命令设置环境变量:export password=mypassword
注意:我们建议对敏感信息使用环境变量。
示例:Telegraf 环境变量
在 Telegraf 环境变量文件 ( /etc/default/telegraf
) 中:
USER="alice"
INFLUX_URL="https://us-west-2-1.aws.cloud2.influxdata.com"
INFLUX_SKIP_DATABASE_CREATION="true"
INFLUX_PASSWORD="monkey123"
在 Telegraf 配置文件 ( /etc/telegraf.conf
) 中:
[global_tags]
user = "${USER}"
[[inputs.mem]]
[[outputs.influxdb]]
urls = ["${INFLUX_URL}"]
skip_database_creation = ${INFLUX_SKIP_DATABASE_CREATION}
password = "${INFLUX_PASSWORD}"
上面的环境变量将以下配置设置添加到 Telegraf:
[global_tags]
user = "alice"
[[outputs.influxdb]]
urls = "https://us-west-2-1.aws.cloud2.influxdata.com"
skip_database_creation = true
password = "monkey123"
启动电报
接下来,您需要启动 Telegraf 服务并将其定向到您的配置文件:
macOS自制软件
telegraf --config telegraf.conf
Linux(sysvinit 和 upstart 安装)
sudo service telegraf start
Linux(系统安装)
systemctl start telegraf