Configure Telegraf integrations

Supported Telegraf plugins include Fluentd, HAProxy, NGINX Plus API, NTPQ, StatsD, and Varnish. See Telegraf plugin directory for details.

1. In SolarWinds Observability, click Add Data at the top.

2. Click Integration, and then click the Telegraf plugin you want to monitor.

3. Select a host with the SolarWinds Observability Agent to use for monitoring the Telegraf integration.

   You can use an Agent in Docker. However, every time you update Docker, your changes in the telegraf.conf will be undone and you will have to customize the configuration file again.

4. Review the integration details (display name, collection interval) and deploy the Agent. See configuration details for the integration:

   • Fluentd Input Plugin
   • HAProxy Input Plugin
   • NGINX Plus API Input Plugin
   • NTPQ Input Plugin
   • StatsD Input Plugin
   • Varnish Input Plugin

5. Review and adjust the configuration file and click Apply & Reload.

   A new entity for the integration is created. You can see the collected metrics in the Metrics Explorer or in the entity details view.

   StatsD does not have an entity. You can only view the collected metrics in the Metrics Explorer.

Edit Telegraf integrations

1. In SolarWinds Observability, click Settings > Integrations > Agent-based.

2. Click the Telegraf integration name to see a list of the integrations monitored by SolarWinds Observability.

3. Click the Enabled toggle to stop/start collecting data for the integration.

4. Click the vertical ellipsis at the end of the entity row to review available management options:

   • Click Manage Agent to review the agent details and access agent management options.

   • Click Edit to change the integration display name, collection interval, or see the path to the configuration file.

   • Click Remove to remove the integration from SolarWinds Observability.

     When you remove the plugin, you will stop getting new data for the related entity. The entity will be deleted after 30 days without new data.

Troubleshooting

Cannot find the configuration file as indicated in the wizard

Plugin deployment in progress

If you cannot find the configuration file telegraf.conf as indicated in the wizard, the plugin deployment might not be completed and the file might not be available yet. It can take up to one minute for the deployment to complete. Please wait a minute.

Different path for plugins in containers

If you deployed the Agent via Configuration Management Tools, such as Chef, Ansible, or Docker, the path to telegraf.conf is as follows:

/uamsclient/workdir/plugin-storage/uams-telegraf-plugin/<plugin-instance-name>/telegraf.conf

Configuration issue - incorrect configuration file

When you upgrade the Docker image, the Docker image is redeployed and the configuration file is recreated without your customizations. As a consequence, a configuration issue for the Telegraph plugin will occur.

When you open the Agent-based integration settings for the integration, the integration status will be Failed.

1. In SolarWinds Observability, click Settings > Agent-based integrations, and click the Telegraf integration with issues.

2. Click the vertical ellipsis next to the Failed integration and select Edit. The Edit Configuration wizard opens.

3. Review the details and the path to the configuration path.

4. Customize the telegraf.conf file as required for the integration:

5. On Summary, review the details and click Apply & Reload.

The warning will be cleared and the integration data will be available in SolarWinds Observability again.