Skip to main content

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 ingests, identifies anomalies, and visualizes Telegraf metrics. You can configure the Telegraf plugin to post data to Moogsoft Cloud 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 Cloud. 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:

  1. Open the configuration file for the Telegraf agent you wish to have write to Moogsoft.

  2. Locate the HTTP block in the .config file in the section [[outputs.http]].

    APIKEYandURL-Telegraf.png
  3. Paste the Moogsoft API_KEY and Moogsoft 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.

  4. Save the Telegraf configuration file and restart the endpoint agent.

  5. Navigate to the Moogsoft Cloud Metrics tab to view Telegraf metrics and anomaly detection data.

    TelegrafMetricsActive.png
  6. 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.