---
title: Automatically configure Telegraf
description: Use the InfluxDB UI to automatically generate a Telegraf configuration, then start Telegraf using the generated configuration file.
url: https://docs.influxdata.com/influxdb/cloud/write-data/no-code/use-telegraf/auto-config/
estimated_tokens: 1915
product: InfluxDB Cloud (TSM)
version: cloud
---

# Automatically configure Telegraf

The InfluxDB user interface (UI) can automatically create Telegraf configuration files based on user-selected Telegraf plugins. This article describes how to create a Telegraf configuration in the InfluxDB UI and start Telegraf using the generated configuration file.

Only a subset of plugins are configurable using the InfluxDB UI. To use plugins other than those listed, you must [manually configure Telegraf](/influxdb/cloud/write-data/no-code/use-telegraf/manual-config).

*View the [requirements](/influxdb/cloud/write-data/no-code/use-telegraf#requirements) for using Telegraf with InfluxDB v2.0.*

## Create a Telegraf configuration

1. Open the InfluxDB Cloud UI.
    
2. In the navigation menu on the left, select **Data** (**Load Data**) > **Telegraf**.
    
    Load Data
    
3. Click **Create Configuration**.
    
4. In the **Bucket** dropdown, select the bucket where Telegraf will store collected data.
    
5. Select one or more of the available plugin groups and click **Continue**.
    
6. Review the list of **Plugins to Configure** for configuration requirements. Plugins listed with a require no additional configuration. To configure a plugin or access plugin documentation, click the plugin name.
    
    Not all available plugins are listed on this screen. For more information on manually configuring additional plugins, see [Manually add Telegraf plugins](/influxdb/cloud/write-data/no-code/use-telegraf/manual-config/).
    
7. Provide a **Telegraf Configuration Name** and an optional **Telegraf Configuration Description**.
    
8. Click **Create and Verify**.
    
9. The **Test Your Configuration** page provides instructions for how to start Telegraf using the generated configuration. *See [Start Telegraf](#start-telegraf) below for detailed information about what each step does.*
    
10. Once Telegraf is running, click **Listen for Data** to confirm Telegraf is successfully sending data to InfluxDB. Once confirmed, a **Connection Found!** message appears.
    
11. Click **Finish**. Your Telegraf configuration name and the associated bucket name appears in the list of Telegraf configurations.
    
    ### Windows
    
    If you plan to monitor a Windows host using the System plugin, you must complete the following steps.
    
    1. In the list of Telegraf configurations, double-click your Telegraf configuration, and then click **Download Config**.
    2. Open the downloaded Telegraf configuration file and replace the `[[inputs.processes]]` plugin with one of the following Windows plugins, depending on your Windows configuration:
    
    -   [`[[inputs.win_perf_counters]]`](https://github.com/influxdata/telegraf/tree/master/plugins/inputs/win_perf_counters)
    -   [`[[inputs.win_services]]`](https://github.com/influxdata/telegraf/tree/master/plugins/inputs/win_services)
    
    3. Save the file and place it in a directory that **telegraf.exe** can access.
    

## Start Telegraf

Requests to the [InfluxDB v2 API](/influxdb/cloud/reference/api/) must include an API token. A token identifies specific permissions to the InfluxDB instance.

### Configure your token as an environment variable

1. Find your API token. *For information about viewing tokens, see [View tokens](/influxdb/cloud/admin/tokens/view-tokens/).*
    
2. To configure your token as the `INFLUX_TOKEN` environment variable, run the command appropriate for your operating system and command-line tool:
    

<!-- Tabbed content: Select one of the following options -->

**macOS or Linux:**

```sh
export INFLUX_TOKEN=YourAuthenticationToken
```

**Windows:**

<!-- Tabbed content: Select one of the following options -->

**PowerShell:**

```sh
$env:INFLUX_TOKEN = "YourAuthenticationToken"
```

**CMD:**

```sh
set INFLUX_TOKEN=YourAuthenticationToken
# Make sure to include a space character at the end of this command.
```

<!-- End tabbed content -->

<!-- End tabbed content -->

### Start the Telegraf service

Start the Telegraf service using the `-config` flag to specify the location of the generated Telegraf configuration file.

-   For Windows, the location is always a local file path.
-   For Linux and macOS, the location can be a local file path or URL.

Telegraf starts using the Telegraf configuration pulled from InfluxDB API.

InfluxDB host URLs and ports differ between InfluxDB OSS and InfluxDB Cloud. For the exact command, see the Telegraf configuration **Setup Instructions** in the InfluxDB UI.

```sh
telegraf -config https://cloud2.influxdata.com/api/v2/telegrafs/0xoX00oOx0xoX00o
```

## Manage Telegraf configurations

For more information about managing Telegraf configurations in InfluxDB, see [Telegraf configurations](/influxdb/cloud/tools/telegraf-configs/).

#### Related

-   [Create a Telegraf configuration](/influxdb/cloud/tools/telegraf-configs/create/)