入门

在您 下载并安装 Telegraf 后，您就可以开始收集和发送数据了。要收集和发送数据，请执行以下操作：

1. 配置 Telegraf
2. 启动 Telegraf
3. 使用 Telegraf 中可用的插件 来收集、转换和输出数据。

配置 Telegraf

在配置文件中定义 Telegraf 将使用的插件。每个配置文件至少需要一个已启用的 输入插件（指标的来源）和至少一个已启用的 输出插件（指标的去向）。

以下示例生成一个包含所有可用插件的示例配置文件，然后使用 filter 标志启用特定插件。

1. 运行以下命令来创建配置文件

   telegraf --sample-config > telegraf.conf

2. 找到配置文件。位置取决于您的系统

   • macOS Homebrew：/usr/local/etc/telegraf.conf
   • Linux debian 和 RPM 包：/etc/telegraf/telegraf.conf
   • 独立二进制文件：有关如何创建配置文件的信息，请参阅下一节

   注意：您还可以指定一个远程 URL 端点来拉取配置文件。请参阅 配置文件位置。

3. 使用 vim 或文本编辑器编辑配置文件。由于此示例使用 InfluxDB V2 输出插件，我们需要在此配置文件部分添加 InfluxDB URL、身份验证令牌、组织和存储桶的详细信息。

注意：有关更多配置文件选项，请参阅 配置选项。

4. 在此示例中，使用 --input-filter 标志指定两个输入（cpu 和 mem）。使用 --output-filter 标志指定 InfluxDB 作为输出。

telegraf --sample-config --input-filter cpu:mem --output-filter influxdb_v2 > telegraf.conf

生成的配置将收集 CPU 和内存数据，并将其发送到 InfluxDB V2。

有关如何配置插件的概述，请观看以下视频

设置环境变量

通过在配置文件的任何位置添加 $ 前缀来设置环境变量。对于字符串，变量必须加引号（例如，"$STR_VAR"）。对于数字和布尔值，变量必须不加引号（例如，$INT_VAR，$BOOL_VAR）。

您也可以使用 Linux export 命令设置环境变量：export password=mypassword

注意：我们建议对敏感信息使用环境变量。

示例：Telegraf 环境变量

在 Telegraf 环境变量文件（/etc/default/telegraf）中

USER="alice"
INFLUX_URL="https://:8086"
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://:8086"
  skip_database_creation = true
  password = "monkey123"

启动 Telegraf

接下来，您需要启动 Telegraf 服务并将其指向您的配置文件

macOS Homebrew

telegraf --config telegraf.conf

Linux (systemd 安装)

systemctl start telegraf