---
title: Configure Telegraf for InfluxDB
description: Telegraf is a plugin-based agent with plugins that are enabled and configured in your Telegraf configuration file (telegraf.conf). Update existing or create new Telegraf configurations to use the influxdb_v2 output plugin to write to InfluxDB. Start Telegraf using the custom configuration.
url: https://docs.influxdata.com/influxdb3/cloud-dedicated/write-data/use-telegraf/configure/
estimated_tokens: 1735
product: InfluxDB Cloud Dedicated
version: cloud-dedicated
---

# Configure Telegraf for InfluxDB

Use the Telegraf `influxdb_v2` output plugin to collect and write metrics to InfluxDB Cloud Dedicated. Learn how to enable the plugin in new and existing Telegraf configurations, and then start Telegraf using the custom configuration file.

*View the [requirements](/influxdb3/cloud-dedicated/write-data/use-telegraf#requirements) for using Telegraf with InfluxDB Cloud Dedicated.*

-   [Configure Telegraf input and output plugins](#configure-telegraf-input-and-output-plugins)
    -   [Add Telegraf plugins](#add-telegraf-plugins)
    -   [Enable and configure the InfluxDB v2 output plugin](#enable-and-configure-the-influxdb-v2-output-plugin)
        -   [urls](#urls)
        -   [token](#token)
        -   [organization](#organization)
        -   [bucket](#bucket)
        -   [Write to InfluxDB v1.x and InfluxDB Cloud Dedicated](#write-to-influxdb-v1x-and-influxdb-cloud-dedicated)
    -   [Other Telegraf configuration options](#other-telegraf-configuration-options)
-   [Start Telegraf](#start-telegraf)

## Configure Telegraf input and output plugins

Configure Telegraf input and output plugins in the Telegraf configuration file (typically named `telegraf.conf`). Input plugins collect metrics. Output plugins define destinations where metrics are sent.

This guide assumes you followed [Setup instructions](/influxdb3/cloud-dedicated/get-started/setup/) in the Get Started tutorial to set up InfluxDB and [configure authentication credentials](/influxdb3/cloud-dedicated/get-started/setup/?t=Telegraf).

### Add Telegraf plugins

To add any of the available [Telegraf plugins](/telegraf/v1/plugins/), follow the steps below.

1. Find the plugin you want to enable from the complete list of available [Telegraf plugins](/telegraf/v1/plugins/).
2. Click **View** to the right of the plugin name to open the plugin page on GitHub. For example, view the [MQTT plugin GitHub page](https://github.com/influxdata/telegraf/blob/master/plugins/inputs/mqtt_consumer/README.md).
3. Copy and paste the example configuration into your Telegraf configuration file (typically named `telegraf.conf`).

### Enable and configure the InfluxDB v2 output plugin

To send data to InfluxDB Cloud Dedicated, enable the [`influxdb_v2` output plugin](/telegraf/v1/output-plugins/influxdb_v2/) in the `telegraf.conf`.

```toml
[[outputs.influxdb_v2]]
  urls = ["https://cluster-id.a.influxdb.io"]
  # INFLUX_TOKEN is an environment variable you created for your database WRITE token

  token = "${INFLUX_TOKEN}"
  organization = ""
  bucket = "DATABASE_NAME"
```

Replace the following:

-   **`DATABASE_NAME`**: the name of the InfluxDB [database](/influxdb3/cloud-dedicated/admin/databases/) to write data to

The InfluxDB output plugin configuration contains the following options:

##### `urls`

An array of URL strings. To write to InfluxDB Cloud Dedicated, include your InfluxDB Cloud Dedicated cluster URL using the HTTPS protocol:

```toml
["https://cluster-id.a.influxdb.io"]
```

##### `token`

Your InfluxDB Cloud Dedicated [database token](/influxdb3/cloud-dedicated/admin/tokens/#database-tokens) with *write* permission to the database.

In the examples, **`INFLUX_TOKEN`** is an environment variable assigned to a [database token](/influxdb3/cloud-dedicated/admin/tokens/#database-tokens) that has *write* permission to the database.

##### `organization`

For InfluxDB Cloud Dedicated, set this to an empty string (`""`).

##### `bucket`

The name of the InfluxDB Cloud Dedicated database to write data to.

##### Write to InfluxDB v1.x and InfluxDB Cloud Dedicated

If a Telegraf agent is already writing to an InfluxDB v1.x database, enabling the InfluxDB v2 output plugin will write data to both v1.x and your InfluxDB Cloud Dedicated cluster.

### Other Telegraf configuration options

`influx_uint_support`: supported in InfluxDB 3.

For more plugin options, see [`influxdb`](/telegraf/v1/output-plugins/influxdb/) on GitHub.

## Start Telegraf

Start the Telegraf service using the `--config` flag to specify the location of your `telegraf.conf`.

```sh
telegraf --config /path/to/custom/telegraf.conf
```

#### Related

-   [Plugin directory](/telegraf/v1/plugins/)