Configure the Telegraf agent on a Linux VM

Products

• VCF Operations
• VMware Telco Cloud Platform

Issue/Introduction

For Linux machines (physical or virtual), you can setup and configure the open source telegraf agent to receive custom data.

• How to:
  • configure the Telegraf agent
  • collect collect metrics from within the guest OS
  • collect custom metrics/properties

Environment

Aria Ops, vROps: 8.16.x, 8.17.x, 8.18.x, 8.18.6

TCP: 5.x, 5.0, 5.0.1, 5.0.2, 5.1

Resolution

Prerequisite:

In order to setup a telegraf agent, you must install the cloud proxy first. See Installing Cloud Proxy in Aria Operations

1. Install and Configure Open Source Telegraf agent

   • Also see Telegraf downloads

2. Obtain the helper script from the cloud proxy:  

   https://<CloudProxy>/downloads/salt/telegraf-utils.sh

3. Navigate to the directory where the script is downloaded

4. Activate execution permission of the script for Linux VM.
   
   chmod +x telegraf-utils.sh

5. Acquire an API authentication token

6. Run the helper script to update Telegraf configurations
   
   curl -ks -X POST https://<ariaOps_IP>/suite-api/api/auth/<apiAuthToken>/acquire -H \"Content-Type: application/json\" -H \"Accept: application/json\" -d \"{\"username\":\"<USER>\",\"password\":\"<USER_PW>\"}\")

7. Restart the Telegraf service
   
   systemctl restart telegraf 
   or
   /usr/bin/telegraf -config /etc/telegraf/telegraf.conf -config-directory /etc/telegraf/telegraf.d

Additional Information

• Full instructions here: Monitoring Applications using Open Source Telegraf on a Linux Platform