---
title: Create a Telegraf configuration
description: Use the InfluxDB UI or the influx CLI to create an Telegraf configuration.
url: https://docs.influxdata.com/influxdb/cloud/tools/telegraf-configs/create/
estimated_tokens: 666
product: InfluxDB Cloud (TSM)
version: cloud
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb/cloud/tools/telegraf-configs/create/
date: '2025-04-02T15:54:32-06:00'
lastmod: '2025-04-02T15:54:32-06:00'
---

Telegraf has an extensive list of plugins for many different technologies and use cases.
Not all plugins are available through the InfluxDB UI, but you can[create and upload custom Telegraf configurations](#create-a-custom-telegraf-configuration)to include any of the available [Telegraf plugins](/telegraf/v1/plugins/).

Use the InfluxDB user interface (UI) or the [`influx` CLI](/influxdb/cloud/reference/cli/influx/)to create a Telegraf configuration.

To create a Telegraf configuration, do one of the following:

* [Use the InfluxDB UI](#use-the-influxdb-ui)
* [Use the `influx` CLI](#use-the-influx-cli)
* [Create a custom Telegraf configuration](#create-a-custom-telegraf-configuration)

## Use the InfluxDB UI

Use the InfluxDB UI to automatically generate and store new Telegraf configurations in InfluxDB.
Creating the configuration in the UI lets you select from a list of available technologies and generates a Telegraf configuration to collect metrics from those technologies.
For more information, see [Automatically configure Telegraf](/influxdb/cloud/write-data/no-code/use-telegraf/auto-config/).

## Use the influx CLI

Use the [`influx telegrafs create` command](/influxdb/cloud/reference/cli/influx/telegrafs/create/)to upload a Telegraf configuration file from your local machine and create a new Telegraf
configuration in InfluxDB.

Provide the following:

* **Telegraf configuration name**
* **Telegraf configuration description**
* **Telegraf configuration file**

> [!Note]
> If a **name** and **description** are not provided, they are set to empty strings.

```sh
# Syntax
influx telegrafs create \
  -n <telegraf-config-name> \
  -d <telegraf-config-description> \
  -f /path/to/telegraf.conf

# Example
influx telegrafs create \
  -n "Example Telegraf config"
  -d "This is a description for an example Telegraf configuration."
  -f /path/to/telegraf.conf
```

## Create a custom Telegraf configuration

1. Create a custom Telegraf configuration file that includes the `outputs.influxdb_v2`output plugin. *See [Manually configure Telegraf](/influxdb/cloud/write-data/no-code/use-telegraf/manual-config/)*for more information.
2. Add and customize [Telegraf plugins](/telegraf/v1/plugins/) and save your changes.
3. [Use the `influx telegrafs create` command](#use-the-influx-cli) to upload your
   custom Telegraf configuration to InfluxDB.

#### Related

* [Manually configure Telegraf](/influxdb/cloud/write-data/no-code/use-telegraf/manual-config/)
* [Automatically configure Telegraf](/influxdb/cloud/write-data/no-code/use-telegraf/auto-config/)
* [Update a Telegraf configuration](/influxdb/cloud/tools/telegraf-configs/update/)