Documentation

Use Grafana with InfluxDB OSS

Use Grafana or Grafana Cloud to visualize data from your InfluxDB instance.

The instructions in this guide require Grafana Cloud or Grafana v7.1+.

  1. Start InfluxDB OSS 2.0.
  2. Sign up for Grafana Cloud or download and install Grafana.
  3. Visit your Grafana Cloud user interface (UI) or, if running Grafana locally, start Grafana and visit http://localhost:3000 in your browser.
  4. In the left navigation of the Grafana UI, hover over the gear icon to expand the Configuration section. Click Data Sources.
  5. Click Add data source.
  6. Select InfluxDB from the list of available data sources.
  7. On the Data Source configuration page, enter a name for your InfluxDB data source.
  8. Under Query Language, select one of the following:

Configure Grafana to use Flux

With Flux selected as the query language in your InfluxDB data source, configure your InfluxDB connection:

  1. Under Connection, enter the following:

  2. Click Save & Test. Grafana attempts to connect to the InfluxDB 2.0 datasource and returns the results of the test.

Configure Grafana to use InfluxQL

With InfluxQL selected as the query language in your InfluxDB data source, configure your InfluxDB connection:

  1. Under HTTP, enter the following:

    • URL: Your InfluxDB URL.

      http://localhost:8086/
    • Access: Server (default)

  2. Under Custom HTTP Headers, select Add Header. Provide your InfluxDB authentication credentials:

  3. Under InfluxDB Details, do the following:

    • Database: Enter the ID of the bucket to query in InfluxDB 2.0. To retrieve your bucket ID, see how to view buckets.
    • User: Enter the username to sign into InfluxDB.
    • Password: Enter the token used to query the bucket above. To retrieve your token, see how to view tokens.
    • HTTP Method: Select GET.


  4. Click Save & Test. Grafana attempts to connect to the InfluxDB 2.0 datasource and returns the results of the test.

Query and visualize data

With your InfluxDB connection configured, use Grafana and Flux to query and visualize time series data stored in your InfluxDB instance.

For more information about using Grafana, see the Grafana documentation. If you’re just learning Flux, see Get started with Flux.


Cloud or OSS?

InfluxDB OSS 2.0 now generally available!

InfluxDB OSS 2.0 is now generally available and ready for production use. See the InfluxDB OSS 2.0 release notes.

For information about upgrading to InfluxDB OSS 2.0, see: