Telegraf integration
Telegraf is a plugin-driven agent used with the InfluxData time series platform to collect, process, aggregate, and write metrics to one or more HTTP (or HTTPS) endpoints via Telegraf configuration file declarations. Moogsoft Cloud ingests, identifies anomalies, and visualizes Telegraf metrics. You can configure the Telegraf plugin to post data to Moogsoft by modifying its configuration file and restarting the endpoint agent.
Before you begin
This integration was validated with Telegraf Version 1.19.1.
Before you start to set up your integration, make sure:
You have an active Telegraf agent on the endpoint(s) for which metrics are to be collected and sent to Moogsoft. Refer to the Telegraf documentation for information about installing a Telegraf agent.
You can access and modify the Telegraf agent configuration file.
You have created an API key and have access to a copy of it.
Telegraf can make requests to external endpoints over port 443. This is the default.
Modify the Telegraf configuration file
To create a new Telegraf integration, modify the Telegraf .config file HTTP block shown below as follows:
Open the configuration file for the Telegraf agent you wish to have write to Moogsoft.
Locate the HTTP block in the .config file in the section [[outputs.http]].
Paste the Moogsoft API_KEY and URL in the
URL=field.Example:
url = "https://MoogsoftAPIKey@api.moogsoft.ai/v1/integrations/metrics/telegraf-json"Note
Be sure the METHOD is always set to POST in the configuration file HTTP block, and FORMAT is always set to JSON.
Save the Telegraf configuration file and restart the endpoint agent.
Navigate to the Moogsoft Metrics tab to view Telegraf metrics and anomaly detection data.
If relevant to your organization, select the appropriate profile from the Alerting profile list. If your company has only one profile, you can leave this set to Default.