---
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: 4256
product: InfluxDB Cloud (TSM)
version: cloud
---

# Use Grafana with InfluxDB Cloud

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:
    
    ```ini
    [feature_toggles]
    enable = newInfluxDSConfigPageDesign
    ```
    
    Configuration file locations:
    
    -   **Linux**: `/etc/grafana/grafana.ini`
    -   **macOS (Homebrew)**: `/opt/homebrew/etc/grafana/grafana.ini`
    -   **Windows**: `<GRAFANA_INSTALL_DIR>\conf\grafana.ini`
    
    [](#option-2-command-line)
    
    Option 2: Command line
    
    Enable the feature flag when starting Grafana:
    
    <!-- Tabbed content: Select one of the following options -->
    
    
    **Linux:**
    
    ```sh
    grafana-server --config /etc/grafana/grafana.ini \
      cfg:default.feature_toggles.enable=newInfluxDSConfigPageDesign
    ```
    
    
    
    **macOS (Homebrew):**
    
    ```sh
    /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
    ```
    
    
    
    **Windows:**
    
    ```powershell
    grafana-server.exe --config <GRAFANA_INSTALL_DIR>\conf\grafana.ini `
      cfg:default.feature_toggles.enable=newInfluxDSConfigPageDesign
    ```
    
    
    
    <!-- End tabbed content -->
    
    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.
    

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–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).

<!-- Tabbed content: Select one of the following options -->

**Flux:**

## 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)](/img/grafana/influxdb-cloud-grafana-flux.png)

Click **Save & Test**. Grafana attempts to connect to InfluxDB Cloud and returns the results of the test.

**InfluxQL:**

## 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](/img/grafana/influxdb-cloud-grafana-influxql.png)

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

**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.

<!-- End tabbed content -->

## 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/)