---
title: Use Telegraf to write data
description: Use Telegraf to collect and write data to InfluxDB 3 Enterprise.
url: https://docs.influxdata.com/influxdb3/enterprise/write-data/use-telegraf/
estimated_tokens: 1345
product: InfluxDB 3 Enterprise
version: enterprise
---

# Use Telegraf to write data

[Telegraf](https://www.influxdata.com/time-series-platform/telegraf/) is a data collection agent for collecting and reporting metrics. Its vast library of input plugins and “plug-and-play” architecture lets you quickly and easily collect metrics from many different sources.

For a list of available plugins, see [Telegraf plugins](/telegraf/v1/plugins/).

#### Requirements

-   **Telegraf 1.9.2 or greater**. *For information about installing Telegraf, see the [Telegraf Installation instructions](/telegraf/v1/install/).*

## Basic Telegraf usage

Telegraf is a plugin-based agent with plugins that are enabled and configured in your Telegraf configuration file (`telegraf.conf`). Each Telegraf configuration must **have at least one input plugin and one output plugin**.

Telegraf input plugins retrieve metrics from different sources. Telegraf output plugins write those metrics to a destination.

Use the [`outputs.influxdb_v2`](/telegraf/v1/plugins/#output-influxdb_v2) plugin to connect to the InfluxDB v2 write API included in InfluxDB 3 Enterprise and write metrics collected by Telegraf to InfluxDB 3 Enterprise.

```toml
# ...

[[outputs.influxdb_v2]]
  urls = ["http://localhost:8181"]
  token = "AUTH_TOKEN"
  organization = ""
  bucket = "DATABASE_NAME"

# ...
```

Replace the following:

-   `DATABASE_NAME`: the name of the database to write data to
-   `AUTH_TOKEN`: your InfluxDB 3 Enterprise [token](/influxdb3/enterprise/admin/tokens/) . *Store this in a secret store or environment variable to avoid exposing the raw token string.*

*See how to [Configure Telegraf to write to InfluxDB 3 Enterprise](/influxdb3/enterprise/write-data/use-telegraf/configure/).*

## Use Telegraf with InfluxDB

### [Configure Telegraf to write to InfluxDB 3 Enterprise](/influxdb3/enterprise/write-data/use-telegraf/configure/)

Update existing or create new Telegraf configurations to use the `influxdb_v2` output plugin to write to InfluxDB 3 Enterprise. Start Telegraf using the custom configuration.

### [Use Telegraf to dual write to InfluxDB](/influxdb3/enterprise/write-data/use-telegraf/dual-write/)

Configure Telegraf to write data to multiple InfluxDB instances or clusters simultaneously.

### [Use Telegraf to write CSV data](/influxdb3/enterprise/write-data/use-telegraf/csv/)

Use the Telegraf `file` input plugin to read and parse CSV data into [line protocol](/influxdb3/enterprise/reference/syntax/line-protocol/) and write it to InfluxDB 3 Enterprise.

![InfluxDB University](/svgs/influxdbu-full-white.svg)

#### Data Collection with Telegraf

Learn how to use Telegraf to make data time series data collection easy in this **free** InfluxDB University course.

[Take the course](https://university.influxdata.com/courses/data-collection-with-telegraf-tutorial/)