Telegraf

important

This application is supported by TNA Connect V2 only and requires a V2 Service subscription.

Telegraf is an open-source agent for collecting, processing, aggregating, and writing metrics. It is used to collect different hardware and software metrics about the TNA and send them to evalink talos.

Install and Configure Telegraf

info

You need to enable Docker before you proceed with the steps below.

Access level 3 or above is required to install and configure Telegraf.

To install and configure Telegraf, do the following:

1. On the TNA Web Server, click on view_module Integrations from the top navigation menu and choose Docker

2. To install Telegraf, go to the Telegraf tab and click on Install under the Configuration tab

   Once installed, the state changes from Not installed to Stopped at the bottom of the page, in the Applications tab, and in the Home page.

3. (Optional) Toggle Auto Update to automatically update Telegraf to the latest version after a firmware update

4. Configure the following settings:

Name	Description
Stream Name	The unique identifier of Kinesis data stream. Maximum: 32 characters Note: The value should not contain spaces or other special characters.
Region	The specific AWS geographical area where Kinesis data stream is hosted. Maximum: 24 characters Examples of commonly used AWS Regions and their codes: Europe (Ireland): eu-west-1 US East (N. Virginia): us-east-1 US West (Oregon): us-west-2 Asia Pacific (Mumbai): ap-south-1 You can find the full list of AWS Regions in the AWS Regions Table.
Access Key	The access key for the IAM user. Maximum: 64 characters
Secret Key	The secret key for the IAM user. Maximum: 64 characters

5. Click on Save

6. (Optional) Click on Undo changes to reset the parameters to their previous values

7. Click on Start to start Telegraf

   The state changes from Stopped to Started at the bottom of the page, in the Applications tab, and in the Home page.

8. (Optional) Click on Stop to stop Telegraf

9. (Optional) Click on Uninstall to remove Telegraf

   A confirmation prompt appears. To delete all associated data and configuration, select the checkbox before clicking Confirm. Click Cancel to keep the application.

View Logs

To view the log output for Telegraf in real time and download the full log into a separate file, do the following:

1. Under the Telegraf tab, click on Logs

2. Click on Read Logs to display live log data in the text field

   Once started, a notification is shown at the lower left corner of the page

3. (Optional) Enable the Autoscroll toggle to keep the latest log entries visible as they update in real-time

4. (Optional) Click on Download Log to download the full log data into a separate file

5. (Optional) Click on Clear to clear the text field

View TNA Metrics

After you configure and start Telegraf, you can view the TNA metrics it collects from evalink analytics:

1. On your evalink talos account, navigate to Analytics, then click on Open Analytics from the upper right corner

2. From the right menu, click on grid_view then Browse to list the available dashboards

3. From the listed dashboards, select the TNA telemetry dashboard to view it