Install Telegraf

Prerequisites 

This section describes prerequisites for installing Telgraf.

Get Telegraf

Download the 1.16 release of Telegraf. 

Install Telegraf on Ubuntu or Debian with apt-get

This section has instructions for installing the latest stable version of Telegraf on Ubuntu or Debian using the apt-get package manager. 

1. Add the InfluxData repository.
   • To add the repository on Ubuntu, run the following command in a terminal window.
     
     wget -qO- https://repos.influxdata.com/influxdb.key | sudo apt-key add -
source /etc/lsb-release
echo "deb https://repos.influxdata.com/${DISTRIB_ID,,} ${DISTRIB_CODENAME} stable" | sudo tee /etc/apt/sources.list.d/influxdb.list
      
   • To add the repository on Debian, run the following commands in a terminal window, skipping the comment lines, which begin with #.
     
     # Before adding Influx repository, run this so that apt will be able to read the repository.

sudo apt-get update && sudo apt-get install apt-transport-https

# Add the InfluxData key

wget -qO- https://repos.influxdata.com/influxdb.key | sudo apt-key add -
source /etc/os-release
test $VERSION_ID = "7" && echo "deb https://repos.influxdata.com/debian wheezy stable" | sudo tee /etc/apt/sources.list.d/influxdb.list
test $VERSION_ID = "8" && echo "deb https://repos.influxdata.com/debian jessie stable" | sudo tee /etc/apt/sources.list.d/influxdb.list
test $VERSION_ID = "9" && echo "deb https://repos.influxdata.com/debian stretch stable" | sudo tee /etc/apt/sources.list.d/influxdb.list
test $VERSION_ID = "10" && echo "deb https://repos.influxdata.com/debian buster stable" | sudo tee /etc/apt/sources.list.d/influxdb.list
      
2. To install and start the Telegraf service, run the following commands in a terminal window:
   
   sudo apt-get update && sudo apt-get install telegraf
sudo service telegraf start
   
   Or, if your operating system uses systemd (Ubuntu 15.04+, Debian 8+):
   
   sudo apt-get update && sudo apt-get install telegraf
sudo systemctl start telegraf

Manually install Telegraf on Debian from a .deb file

To manually install the Debian package from a .deb file:

1. Download the latest Telegraf .deb release from the Telegraf section of the downloads page.
2. Run the following command (making sure to supply the correct version number for the downloaded file):
   
   sudo sudo dpkg -i telegraf_1.<version>_amd64.deb

Install Telegraf on Windows

Telegraf has native support for running as a Windows service.

1. Download the Telegraf binary and unzip its contents to C:\Program Files\InfluxData\Telegraf.
2. Launch PowerShell as an administrator.
3. In PowerShell, run these commands:
   > cd "C:\Program Files\InfluxData\Telegraf"
> .\telegraf.exe --service install --config "C:\Program Files\InfluxData\Telegraf\telegraf.conf"
4. To test that the installation works, run:
   > C:\"Program Files"\InfluxData\Telegraf\telegraf.exe --config C:\"Program Files"\InfluxData\Telegraf\telegraf.conf --test
5. To start collecting data, run:
   telegraf.exe --service start

Adjust the collection interval

You can adjust the collection and reporting intervals in the [agent] block of your Telegraf configuration. The scraping interval is configured with the interval property, and the flush_interval property specifies the interval at which the data will be sent to configured outputs. Specify durations by combining an integer value and time unit as a string value. Valid time units are ns, us (or µs), ms, s, m, h. The default is 10 seconds. The following example collects and send metrics to Sumo Logic every 30 seconds.

[agent]
  interval = "30s"
  flush_interval = "30s"

Add additional metadata

You may wish to add additional metadata to the metrics that Telegraf collects. You can do so with Global Tags. Global tags can be specified in the [global_tags] table in key="value" format. All metrics that are collected will be tagged with the specified tags.

[global_tags]
  dc = "us-east-1"