Google BigQuery data source
The Google BigQuery data source allows you to query and visualize data from Google BigQuery, Google’s fully managed, serverless data warehouse.
Supported features
Requirements
The following Google APIs must be enabled in your GCP project:
Get started
Install the plugin from Administration > Plugins and data > Plugins, or from the Grafana plugin catalog. After the plugin is installed, the following documents help you get started:
- Configure the BigQuery data source - Set up authentication and connect to BigQuery.
- BigQuery query editor - Create and edit SQL and visual queries.
- Template variables - Create dynamic dashboards with BigQuery variables.
- Alerting - Create alert rules using BigQuery data.
- Troubleshooting - Solve common configuration and query errors.
Additional features
After you configure the BigQuery data source, you can:
- Add Annotations to overlay BigQuery events on your graphs.
- Configure and use Template variables for dynamic dashboards.
- Add Transformations to manipulate query results.
- Set up Alerting rules based on your BigQuery data.
- Use Explore to investigate your BigQuery data without building a dashboard.
- Build queries with Grafana Assistant when it’s available in your Grafana instance.
Pre-built dashboards
The BigQuery data source plugin includes the following pre-built dashboards:
- Array queries examples - Demonstrates how to work with BigQuery arrays and nested data structures.
To import a pre-built dashboard:
- Go to Connections > Data sources.
- Select your BigQuery data source.
- Click the Dashboards tab.
- Click Import next to the dashboard you want to use.
Plugin updates
Always ensure that your plugin version is up-to-date so you have access to all current features and improvements. Navigate to Administration > Plugins and data > Plugins to check for updates.
Note
On Grafana Cloud, the Google BigQuery plugin is managed by Grafana and updates automatically. On self-managed Grafana, you must update the plugin manually. Refer to Version and upgrade guidance.


