开始

在您下载并安装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 output plugin，我们需要在配置文件的这一部分添加 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