Use Grafana to query and visualize data
Use Grafana to query and visualize data stored in InfluxDB Cloud Serverless. Install the grafana-flight-sql-plugin to query InfluxDB with the Flight SQL protocol.
[Grafana] enables you to query, visualize, alert on, and explore your metrics, logs, and traces wherever they are stored. [Grafana] provides you with tools to turn your time-series database (TSDB) data into insightful graphs and visualizations.
- Install Grafana or login to Grafana Cloud
- Install the FlightSQL plugin
- Create and configure a FlightSQL datasource
- Query InfluxDB with Grafana
- Build visualizations with Grafana
Install Grafana or login to Grafana Cloud
If using the open source version of Grafana, follow the Grafana installation instructions to install Grafana for your operating system. If using Grafana Cloud, login to your Grafana Cloud instance.
Install the FlightSQL plugin
When using the local version of Grafana, you can install the FlightSQL plugin
with the grafana-cli
CLI or in
the Grafana user interface (UI).
Use grafana-cli
Run the following command to install the FlightSQL plugin:
grafana-cli plugins install influxdata-flightsql-datasource
After installing the plugin, you may need to restart your Grafana server.
Use the Grafana UI
- In the Grafana UI, navigate to Configuration > Plugins.
- Search for and select the FlightSQL plugin.
- Click Install.
- In your Grafana Cloud instance, navigate to Administration > Plugins.
- Search for and select the FlightSQL plugin.
- Click Install via grafana.com to navigate to the plugin page.
- On the plugin page, click Install plugin.
After a moment, Grafana Cloud completes the plugin installation in your Grafana Cloud instance.
Create and configure a FlightSQL datasource
In your Grafana user interface (UI), navigate to Data Sources.
Click Add new data source.
Search for and select the FlightSQL plugin.
Provide a name for your datasource.
Add your connection credentials:
Host: Provide the host and port of your Flight SQL client. For InfluxDB Cloud Serverless, this is your InfluxDB Cloud Serverless region domain and port 443. For example:
us-east-1-1.aws.cloud2.influxdata.com:443
AuthType: Select token.
Token: Provide your InfluxDB API token with read access to the buckets you want to query.
Require TLS/SSL: Enable this toggle.
Add connection MetaData. InfluxDB Cloud Serverless requires one of the following key-value pairs:
- Key:
database
, Value: Bucket name - Key:
bucket-id
, Value: Bucket ID
- Key:
Click Save & test.
If successful, click Explore to begin querying InfluxDB with Flight SQL and Grafana.
Query InfluxDB with Grafana
After you configure and save a FlightSQL datasource, use Grafana to build, run, and inspect queries against InfluxDB buckets.
When working with the InfluxDB SQL implementation, a bucket is equivalent to a database, a measurement is structured as a table, and time, fields, and tags are structured as columns. To learn more, see Query Data.
- Click Explore.
- In the dropdown, select the saved data source that you want to query.
- Use the SQL query form to build your query:
- FROM: Select the measurement that you want to query.
- SELECT: Select one or more fields and tags to return as columns in query results.
In Grafana, you must specify a time column in the
SELECT
list. - WHERE: To filter the query results, enter a conditional expression.
- GROUP BY: To
GROUP BY
one or more fields or tags, enter them as a comma-delimited list. If you include an aggregate function in the SELECT list, then you must include one or more of the queried columns in aGROUP BY
orPARTITION BY
clause. SQL will return the aggregation for each group or partition.
- Click Run query to execute the query.

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!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB and this documentation. To find support, use the following resources:
InfluxDB Cloud and InfluxDB Enterprise customers can contact InfluxData Support.