Skip to content

Telegraf

Attention

Before using Telegraf, it is recommended to determine whether Datakit can meet the expected data collection. If DataKit is already supported, Telegraf is not recommended for collection, which may lead to data conflicts and cause problems in use.

Telegraf is an open source data collection tool. DataKit can access the data set collected by Telegraf through simple configuration.

Telegraf Installation

Take Ubuntu as an example. For other systems, see：

Add installation source

curl -s 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

Install Telegraf

sudo apt-get update && sudo apt-get install telegraf

Telegraf Configuration

Default profile path:

  • Mac: /usr/local/etc/telegraf.conf
  • Linux: /etc/telegraf/telegraf.conf
  • Windows: The configuration file is in the Telegraf binary sibling directory (depending on the specific installation)

Note: Under Mac, if you install through datakit install --telegraf, the configuration directory is the same as Linux.

Modify the configuration file as follows:

[agent]
    interval                  = "10s"
    round_interval            = true
    precision                 = "ns"
    collection_jitter         = "0s"
    flush_interval            = "10s"
    flush_jitter              = "0s"
    metric_batch_size         = 1000
    metric_buffer_limit       = 100000
    logtarget                 = "file"
    logfile                   = "your_path.log"
    logfile_rotation_interval = ""

# Here you can configure the global tag of the data collected by Telegraf
[global_tags]
  name = "zhangsan"

[[outputs.http]]
    ## URL is the address to send metrics to DataKit ,required
    url         = "http://localhost:9529/v1/write/metric?input=telegraf"
    method      = "POST"
    data_format = "influx" # You must select `influx` here, otherwise DataKit cannot parse the data

# More other configurations ...

If the DataKit API location is adjusted, you need to adjust the following configuration by setting the url to the real address of the DataKit API:

[[outputs.http]]
   ## URL is the address to send metrics to
   url = "http://127.0.0.1:9529/v1/write/metric?input=telegraf"

Telegraf's collection configuration is similar to DataKit, and it is also in Toml formatSpecifically, each collector basically takes [[inputs.xxxx]] as the entrance. Here, take nvidia_smi collection as an example:

[[inputs.nvidia_smi]]
  ## Optional: path to nvidia-smi binary, defaults to $PATH via exec.LookPath
  bin_path = "/usr/bin/nvidia-smi"

  ## Optional: timeout for GPU polling
  timeout = "5s"

More Reading

Feedback

Is this page helpful? ×