Configure the InfluxDB connection

In this milestone, you configure the connection details so that Grafana Cloud can query your InfluxDB instance. This includes selecting the query language, entering the URL, and providing your authentication credentials.

The steps below demonstrate configuring with Flux. If you’re using InfluxQL or SQL, the general workflow is the same but the required fields differ. Refer to Configure the InfluxDB data source for the settings specific to your query language.

Note: InfluxData has announced that Flux is being deprecated in favor of SQL. If you’re using InfluxDB 3.x or starting a new deployment, consider selecting SQL as your query language instead.

1. Under URL, enter the URL of your InfluxDB instance.

   For example: http://influxdb.example.com:8086

2. Under Product, select your InfluxDB version.

   For InfluxDB 2.x, select InfluxDB OSS 2.x.

   Note: The remaining steps in this milestone assume you’ve selected a product that supports Flux: InfluxDB OSS 2.x, InfluxDB OSS 1.x, InfluxDB Enterprise 1.x, InfluxDB Cloud (TSM), or InfluxDB Cloud Serverless.

3. Under Query language, select your preferred language.

   This path demonstrates Flux, which is supported by InfluxDB 2.x and some 1.x versions. If you’re using InfluxDB 3.x, select SQL. If you’re using InfluxDB 1.x without Flux support, select InfluxQL.

   After selecting the product and query language, the Database settings section becomes available.

4. Under Database settings > Organization, enter your InfluxDB organization name.

   For example: my-org

5. Under Database settings > Token, enter your InfluxDB API token.

   This is the read-only token you created in the previous milestone.

6. Under Database settings > Default Bucket, enter the name of the bucket you want to query.

   For example: telegraf

In the next milestone, you’ll save and test the connection to verify everything is configured correctly.