Getting started with Telegraf

警告! 本页记录了不再积极开发的Telegraf的早期版本. Telegraf v1.13Telegraf的最新稳定版本.

Getting started with Telegraf

Telegraf是用Go语言编写的代理,用于收集指标并将其写入InfluxDB或其他可能的输出. 本指南将帮助您入门和使用Telegraf. 它引导您完成下载,安装和配置过程,并说明如何使用Telegraf将数据导入InfluxDB.

Download and install Telegraf

请遵循" 下载"页面上" Telegraf"部分中的说明 .

注意:从deb软件包安装后,Telegraf将使用默认配置自动启动.

Configuring Telegraf

Configuration file location by installation type

  • macOS Homebrew: /usr/local/etc/telegraf.conf
  • Linux debian和RPM软件包: /etc/telegraf/telegraf.conf
  • 独立二进制文件:有关如何创建配置文件的信息,请参见下一部分

Creating and editing the configuration file

在启动Telegraf服务器之前,您需要编辑和/或创建一个初始配置,该初始配置指定所需的输入 (度量标准来自何处)和输出 (度量标准何处去). 有几种创建和编辑配置文件的方法. 这里,我们将产生一个配置文件,并同时指定与所希望的输入-input-filter标志,并与所需的输出-output-filter标志.

在下面的示例中,我们使用两个输入创建一个名为telegraf.conf的配置文件:一个读取有关系统cpu使用率( cpu )的度量,另一个读取有关系统内存使用率( mem )的度量. 我们将InfluxDB指定为所需的输出.

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

Start the Telegraf service

启动Telegraf服务并将其定向到相关的配置文件:

macOS Homebrew

telegraf --config telegraf.conf

Linux (sysvinit and upstart installations)

sudo service telegraf start

Linux (systemd installations)

systemctl start telegraf

Results

Telegraf启动并运行后,它将开始收集数据并将其写入所需的输出.

返回到示例配置,我们在下面的InfluxDB中显示cpumem数据的外观. 请注意,我们使用默认的输入和输出配置设置来获取这些数据.

> SHOW MEASUREMENTS
name: measurements
------------------
name
cpu
mem
> SHOW FIELD KEYS
name: cpu
---------
fieldKey                fieldType
usage_guest             float
usage_guest_nice	       float
usage_idle		            float
usage_iowait		          float
usage_irq		             float
usage_nice		            float
usage_softirq		         float
usage_steal		           float
usage_system		          float
usage_user		            float

name: mem
---------
fieldKey                fieldType
active			               integer
available		             integer
available_percent	      float
buffered		              integer
cached			               integer
free			                 integer
inactive		              integer
total			                integer
used			                 integer
used_percent		          float
  • 在度量cpu_usage_idle usage_idle 字段中选择一个数据样本:
> SELECT usage_idle FROM cpu WHERE cpu = 'cpu-total' LIMIT 5
name: cpu
---------
time			               usage_idle
2016-01-16T00:03:00Z	 97.56189047261816
2016-01-16T00:03:10Z	 97.76305923519121
2016-01-16T00:03:20Z	 97.32533433320835
2016-01-16T00:03:30Z	 95.68857785553611
2016-01-16T00:03:40Z	 98.63715928982245

请注意,时间戳以十秒舍入为间隔(即:00:10:20等)-这是可配置的设置.

而已! 您现在有了使用Telegraf收集指标并将其写入所选输出的基础.

by  ICOPY.SITE