--- title: Use Grafana with InfluxDB Cloud description: Use Grafana to visualize data from your InfluxDB Cloud instance. url: https://docs.influxdata.com/influxdb/cloud/tools/grafana/ estimated_tokens: 2774 product: InfluxDB Cloud (TSM) version: cloud publisher: InfluxData canonical: https://docs.influxdata.com/influxdb/cloud/tools/grafana/ date: '2026-01-03T13:50:38-06:00' lastmod: '2026-01-03T13:50:38-06:00' --- Use [Grafana](https://grafana.com/) or [Grafana Cloud](https://grafana.com/products/cloud/)to visualize data from your **InfluxDB Cloud** instance. #### Identify your InfluxDB version If you are unsure which InfluxDB product you are using, use our interactive version detector to help identify it: [Detect my InfluxDB version](#) #### Grafana 12.2+ The instructions below are for **Grafana 12.2+** with the `newInfluxDSConfigPageDesign`feature flag enabled. This introduces the newest version of the InfluxDB core plugin. The interface dynamically adapts based on your product and query language selection in [URL and authentication](#configure-url-and-authentication). * [Install Grafana](#install-grafana) * [Create an InfluxDB data source](#create-an-influxdb-data-source) * [Query and visualize data](#query-and-visualize-data) ## Install Grafana 1. [Start InfluxDB OSS 2.x](/influxdb/v2/install/#configure-and-start-influxdb). 2. [Sign up for Grafana Cloud](https://grafana.com/products/cloud/) or[download and install Grafana](https://grafana.com/grafana/download). 3. If running Grafana locally, enable the `newInfluxDSConfigPageDesign` feature flag to use the latest InfluxDB data source plugin. [](#option-1-configuration-file-recommended) Option 1: Configuration file (recommended) Add the following to your `grafana.ini` configuration file: ``` [feature_toggles] enable = newInfluxDSConfigPageDesign ``` Configuration file locations: * **Linux**: `/etc/grafana/grafana.ini` * **macOS (Homebrew)**: `/opt/homebrew/etc/grafana/grafana.ini` * **Windows**: `\conf\grafana.ini` [](#option-2-command-line) Option 2: Command line Enable the feature flag when starting Grafana: #### Linux #### ``` grafana-server --config /etc/grafana/grafana.ini \ cfg:default.feature_toggles.enable=newInfluxDSConfigPageDesign ``` ``` /opt/homebrew/opt/grafana/bin/grafana server \ --config /opt/homebrew/etc/grafana/grafana.ini \ --homepath /opt/homebrew/opt/grafana/share/grafana \ --packaging=brew \ cfg:default.paths.logs=/opt/homebrew/var/log/grafana \ cfg:default.paths.data=/opt/homebrew/var/lib/grafana \ cfg:default.paths.plugins=/opt/homebrew/var/lib/grafana/plugins \ cfg:default.feature_toggles.enable=newInfluxDSConfigPageDesign ``` ``` grafana-server.exe --config \conf\grafana.ini ` cfg:default.feature_toggles.enable=newInfluxDSConfigPageDesign ``` For more information, see [Configure feature toggles](https://grafana.com/docs/grafana/latest/setup-grafana/configure-grafana/feature-toggles/) in the Grafana documentation. 4. Visit your **Grafana Cloud user interface** (UI) or, if running Grafana locally,[start Grafana](https://grafana.com/docs/grafana/latest/installation/) and visit[http://localhost:3000](http://localhost:3000) in your browser. > [!Note] > SQL is only supported in InfluxDB 3. For more information, see how to upgrade to [InfluxDB Cloud Serverless](/influxdb/cloud/upgrade/v2-to-cloud/). ## Quick reference | Configuration | Value | |-------------------------------------------------------------------------------------------------------------|----------------------------------------------| | **Product selection** | | | **InfluxDB Cloud (TSM)** | | | | | | **URL** | | |[Region URL](/influxdb/cloud/reference/regions/)–for example, `https://us-east-2-1.aws.cloud2.influxdata.com`| | | | | | **Query languages** | Flux, InfluxQL | | **Authentication** | API token or v1 username/password | | **Organization** | Organization name or ID (Flux only) | | **Default Bucket** | Default bucket for Flux queries (Flux only) | | **Database** |Database name mapped to bucket (InfluxQL only)| ## Create an InfluxDB data source 1. In your Grafana interface, click **Connections** in the left sidebar. 2. Click **Data sources**. 3. Click **Add new connection**. 4. Search for and select **InfluxDB**. The InfluxDB data source configuration page displays. 5. In the **Settings** tab, enter a **Name** for your data source. ### Configure URL and authentication In the **URL and authentication** section, configure the following: * **URL**: Your[region URL](/influxdb/cloud/reference/regions/)–for example, `https://us-east-2-1.aws.cloud2.influxdata.com` * **Product**: From the dropdown, select**InfluxDB Cloud (TSM)** * **Query Language**: Select **Flux** or **InfluxQL** * *(Optional)* **Advanced HTTP Settings**, **Auth**, and **TLS/SSL Settings** as needed for your environment ### Configure database settings The fields in this section change based on your query language selection in [URL and authentication](#configure-url-and-authentication). [Flux](#) [InfluxQL](#) ## Configure Grafana to use Flux When you select **Flux** as the query language, configure the following: * **Organization**: Your InfluxDB [organization name or ID](/influxdb/v2/admin/organizations/view-orgs/) * **Default Bucket**: The default [bucket](/influxdb/v2/admin/buckets/) to use in Flux queries * **Token**: Your InfluxDB [API token](/influxdb/v2/admin/tokens/) Flux configuration for InfluxDB Cloud (TSM) Click **Save & Test**. Grafana attempts to connect to InfluxDB Cloud and returns the results of the test. ## Configure Grafana to use InfluxQL #### DBRP mapping required To query InfluxDB OSS 2.x with InfluxQL, you must first create Database and Retention Policy (DBRP) mappings. The configuration form displays a warning if DBRP mapping is required. When you select **InfluxQL** as the query language, you can authenticate using either tokens or username/password credentials. ### Token authentication (recommended) Configure the following fields: * **Database**: The database name [mapped to your InfluxDB bucket](#create-dbrp-mappings) * **User**: Enter any string (this field is required by the form) * **Password**: Your InfluxDB [API token](/influxdb/v2/admin/tokens/) ### Username and password authentication Configure the following fields: * **Database**: The database name [mapped to your InfluxDB bucket](#create-dbrp-mappings) * **User**: Your [v1 authorization username](#create-v1-authorizations) * **Password**: Your [v1 authorization password](#create-v1-authorizations) InfluxQL configuration for InfluxDB Cloud (TSM) with v1 auth Click **Save & Test**. Grafana attempts to connect to InfluxDB Cloud and returns the results of the test. ### Create DBRP mappings When using InfluxQL to query InfluxDB, the query must specify a database and retention policy. InfluxDB DBRP mappings associate database and retention policy combinations with InfluxDB OSS 2.x buckets. #### View existing DBRP mappings Use the [`influx v1 dbrp list`](/influxdb/v2/reference/cli/influx/v1/dbrp/list/) command: ```sh influx v1 dbrp list ``` ### Create a DBRP mappings Use the influx v1 dbrp create command: ```sh influx v1 dbrp create \ --db example-db \ --rp example-rp \ --bucket-id 00xX00o0X001 \ --default ``` Provide: * `--db:` Database name * `--rp:` Retention policy name (not retention period) * `--bucket-id:` Bucket ID * `--default:` (Optional) Make this the default retention policy for the database > [!Note] > **Repeat for each DBRP combination**Each unique database and retention policy combination used by Grafana must be mapped to an InfluxDB OSS 2.x bucket. For more information, see [Database and retention policy mapping](/influxdb/v2/api-guide/influxdb-1x/dbrp/). ### Create v1 authorizations InfluxDB OSS 2.x provides a v1-compatible authentication API for username/password authentication. #### View existing v1 authorizations Use the [`influx v1 auth list`](/influxdb/v2/reference/cli/influx/v1/auth/list/) command: ```sh influx v1 auth list ``` #### Create a v1 authorization Use the [`influx v1 auth create`](/influxdb/v2/reference/cli/influx/v1/auth/create/) command: ```sh influx v1 auth create \ --read-bucket 00xX00o0X001 \ --write-bucket 00xX00o0X001 \ --username example-user ``` Provide: * `--read-bucket`: Bucket ID to grant read permissions * `--write-bucket`: Bucket ID to grant write permissions * `--username`: New username You’ll be prompted to enter a password. ## Query and visualize data With your InfluxDB connection configured, use Grafana to query and visualize time series data. ### Query inspection in Grafana To learn about query management and inspection in Grafana, see the[Grafana Explore documentation](https://grafana.com/docs/grafana/latest/explore/). ### Build visualizations with Grafana For a comprehensive walk-through of creating visualizations with Grafana, see the [Grafana documentation](https://grafana.com/docs/grafana/latest/). #### Related * [Grafana documentation](https://grafana.com/docs/) * [Get started with Flux](/influxdb/cloud/query-data/get-started/) * [Query data with InfluxQL](/influxdb/cloud/query-data/influxql/) * [Get started with Flux](/flux/v0/get-started/) [grafana](/influxdb/cloud/tags/grafana/) | Configuration | Value | | --- | --- | | Configuration | Value | | Product selection | | | InfluxDB Cloud (TSM) | | | | | | URL | | | Region URL –for example, https://us-east-2-1.aws.cloud2.influxdata.com | | | | | | Query languages | Flux, InfluxQL | | Authentication | API token or v1 username/password | | Organization | Organization name or ID (Flux only) | | Default Bucket | Default bucket for Flux queries (Flux only) | | Database | Database name mapped to bucket (InfluxQL only) |