--- title: Use Grafana with InfluxDB OSS description: Use Grafana to visualize data from your InfluxDB instance. url: https://docs.influxdata.com/influxdb/v2/tools/grafana/ estimated_tokens: 4402 product: InfluxDB OSS v2 version: v2 --- # Use Grafana with InfluxDB OSS 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). Use [Grafana](https://grafana.com/) or [Grafana Cloud](https://grafana.com/products/cloud/) to visualize data from your **InfluxDB 2.9** 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**: `\conf\grafana.ini` [](#option-2-command-line) Option 2: Command line Enable the feature flag when starting Grafana: **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 \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. #### Using Grafana Cloud with a local InfluxDB instance If you need to keep your database local, consider running Grafana locally instead of using Grafana Cloud, as this avoids the need to expose your database to the internet. To use InfluxDB running on your private network with Grafana Cloud, you must configure a [private data source for Grafana Cloud](https://grafana.com/docs/grafana-cloud/data-sources/private-data-sources/). SQL is only supported in InfluxDB 3. For more information, see how to [get started with InfluxDB 3 Core](/influxdb3/core/get-started/). ## Quick reference | Configuration | Value | | --- | --- | | Product selection | InfluxDB OSS 2.x | | | **URL** | [Server URL](/influxdb/v2/reference/urls/)–for example, `https://localhost:8086` | | **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 [server URL](/influxdb/v2/reference/urls/)–for example, `https://localhost:8086` - **Product**: From the dropdown, select **InfluxDB OSS 2.x** - **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:** ## 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 OSS 2.x](/img/grafana/influxdb-v2-grafana-influxql-flux.png) Click **Save & Test**. Grafana attempts to connect to InfluxDB OSS 2.x 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 OSS 2.x with DBRP warning](/img/grafana/influxdb-v2-grafana-influxql.png) Click **Save & Test**. Grafana attempts to connect to InfluxDB OSS 2.x 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. ## 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 and InfluxDB](/influxdb/v2/query-data/get-started/) [grafana](/influxdb/v2/tags/grafana/)