---
title: Telegraf configurations
description: InfluxDB OSS lets you automatically generate Telegraf configurations or upload custom Telegraf configurations that collect metrics and write them to InfluxDB OSS.
url: https://docs.influxdata.com/influxdb/v2/tools/telegraf-configs/
estimated_tokens: 678
product: InfluxDB OSS v2
version: v2
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb/v2/tools/telegraf-configs/
date: '2025-04-02T15:54:32-06:00'
lastmod: '2025-04-02T15:54:32-06:00'
---

This page documents an earlier version of InfluxDB OSS.[InfluxDB 3 Core](/influxdb3/core/) is the latest stable version.

#### API token hashing is enabled by default in InfluxDB OSS 2.9.0

Stronger token security: tokens are stored as hashes on disk, so a
copy of the database file doesn’t expose usable tokens. Existing
tokens are hashed on first startup and the original strings can’t
be recovered afterward — **capture any plaintext tokens you still
need before you upgrade**.

For more information, see [Token hashing](/influxdb/v2/admin/tokens/#token-hashing).

InfluxDB lets you automatically generate Telegraf configurations or upload custom
Telegraf configurations that collect metrics and write them to InfluxDB.
Telegraf retrieves configurations from InfluxDB on startup.

## Use InfluxDB Telegraf configurations

With a Telegraf configuration stored in InfluxDB, the `telegraf` agent can retrieve
the configuration from an InfluxDB HTTP(S) endpoint.

* Ensure Telegraf has network access to InfluxDB (OSS or Cloud).

* Start the `telegraf` agent using the `--config` flag to provide the URL of the
  InfluxDB Telegraf configuration. For example:

  ```
  telegraf --config http://localhost:8086/api/v2/telegrafs/<telegraf-config-id>
  ```

> [!Note]
> *[Setup instructions](/influxdb/v2/tools/telegraf-configs/view/#view-setup-instructions) for
> each Telegraf configuration are provided in the InfluxDB UI.*

## Manage Telegraf configurations

### [Clone a Telegraf configuration](/influxdb/v2/tools/telegraf-configs/clone/)

Use the InfluxDB UI to clone an Telegraf configuration.

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

Use the InfluxDB UI or the [`influx` CLI](/influxdb/v2/reference/cli/influx/) to create an Telegraf configuration.

### [View Telegraf configurations](/influxdb/v2/tools/telegraf-configs/view/)

Use the InfluxDB user interface (UI) or the [`influx` CLI](/influxdb/v2/reference/cli/influx/) to view and download InfluxDB Telegraf configurations.

### [Update a Telegraf configuration](/influxdb/v2/tools/telegraf-configs/update/)

Use the InfluxDB user interface (UI) or the [`influx` CLI](/influxdb/v2/reference/cli/influx/) to update InfluxDB Telegraf configurations.

### [Remove a Telegraf configuration](/influxdb/v2/tools/telegraf-configs/remove/)

Use the InfluxDB UI or the [`influx` CLI](/influxdb/v2/reference/cli/influx/) to remove Telegraf configurations from InfluxDB.

#### Related

* [Manually configure Telegraf](/influxdb/v2/write-data/no-code/use-telegraf/manual-config/)
* [Automatically configure Telegraf](/influxdb/v2/write-data/no-code/use-telegraf/auto-config/)

[telegraf](/influxdb/v2/tags/telegraf/)