---
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: 974
product: InfluxDB OSS v2
version: v2
---

# Telegraf configurations

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:
    
    ```sh
    telegraf --config http://localhost:8086/api/v2/telegrafs/<telegraf-config-id>
    ```
    

*[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/)