Documentation

Use Grafana with InfluxDB

This page documents an earlier version of InfluxDB OSS. InfluxDB 3 Core is the latest stable version.

Use Grafana or Grafana Cloud to visualize data from your 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

Required

  • The instructions in this guide require Grafana Cloud or Grafana v10.3+. For information about using InfluxDB with other versions of Grafana, see the Grafana documentation.
  • To use Flux, use InfluxDB 1.8.1+ and enable Flux in your InfluxDB configuration file.

Install Grafana

  1. Start InfluxDB.

  2. Sign up for Grafana Cloud or download and install Grafana.

  3. If running Grafana locally, enable the newInfluxDSConfigPageDesign feature flag to use the latest InfluxDB data source plugin.

    Option 2: Command line

    For more information, see Configure feature toggles in the Grafana documentation.

  4. Visit your Grafana Cloud user interface (UI) or, if running Grafana locally, start Grafana and visit 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.

SQL is only supported in InfluxDB 3. For more information, see how to get started with InfluxDB 3 Core.

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–for example, https://localhost:8086
  • Product: From the dropdown, select InfluxDB OSS 1.x
  • Query Language: Select InfluxQL or Flux
  • (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 Grafana to use InfluxQL

When you select InfluxQL as the query language, configure the following:

InfluxQL configuration for InfluxDB OSS 1.x

Click Save & Test. Grafana attempts to connect to InfluxDB and returns the result of the test.

Configure Grafana to use Flux

When you select Flux as the query language, configure the following:

  1. Ensure Flux is enabled in your InfluxDB configuration file.

  2. Configure the database settings:

    • Organization: Provide an arbitrary value (InfluxDB 1.x does not use organizations)
    • Default Bucket: Provide a default database and retention policy
    • Token: If InfluxDB authentication is enabled provide your InfluxDB username and password
Flux configuration for InfluxDB OSS 1.x

Click Save & Test. Grafana attempts to connect to InfluxDB and returns the result of the test.

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.

Build visualizations with Grafana

For a comprehensive walk-through of creating visualizations with Grafana, see the Grafana documentation.


Was this page helpful?

Thank you for your feedback!


New in InfluxDB 3.5

Key enhancements in InfluxDB 3.5 and the InfluxDB 3 Explorer 1.3.

See the Blog Post

InfluxDB 3.5 is now available for both Core and Enterprise, introducing custom plugin repository support, enhanced operational visibility with queryable CLI parameters and manual node management, stronger security controls, and general performance improvements.

InfluxDB 3 Explorer 1.3 brings powerful new capabilities including Dashboards (beta) for saving and organizing your favorite queries, and cache querying for instant access to Last Value and Distinct Value caches—making Explorer a more comprehensive workspace for time series monitoring and analysis.

For more information, check out:

InfluxDB Docker latest tag changing to InfluxDB 3 Core

On November 3, 2025, the latest tag for InfluxDB Docker images will point to InfluxDB 3 Core. To avoid unexpected upgrades, use specific version tags in your Docker deployments.

If using Docker to install and run InfluxDB, the latest tag will point to InfluxDB 3 Core. To avoid unexpected upgrades, use specific version tags in your Docker deployments. For example, if using Docker to run InfluxDB v2, replace the latest version tag with a specific version tag in your Docker pull command–for example:

docker pull influxdb:2