开始使用

在您下载并安装 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="http://localhost: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 = "http://localhost:8086"
  skip_database_creation = true
  password = "monkey123"

启动 Telegraf

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

macOS Homebrew

telegraf --config telegraf.conf

Linux (systemd 安装)

systemctl start telegraf