Skip to main content


Grafana is a monitoring dashboard system, which is an open-source monitoring tool developed by Grafana Labs. It can greatly simplify the complexity of monitoring by allowing us to provide the data to be monitored, and it generates various visualizations. Additionally, it has an alarm function that sends notifications when there is an issue with the system. Databend and Databend Cloud can integrate with Grafana through the Altinity plugin for ClickHouse.

Tutorial: Integrating with Grafana

This tutorial guides you through the process of integrating Databend / Databend Cloud with Grafana using the Altinity plugin for ClickHouse.

Step 1. Set up Environment

Before you start, please refer to the official installation guide to install Grafana: .

For this tutorial, you can integrate either with Databend or Databend Cloud:

  • If you choose to integrate with a local Databend instance, follow the Deployment Guide to deploy it if you don't have one already.
  • If you prefer to integrate with Databend Cloud, make sure you can log in to your account and obtain the connection information for a warehouse. For more details, see Connecting to a Warehouse.

Step 2. Install Altinity plugin for ClickHouse

  1. Click on the gear icon in the sidebar on the Grafana homepage, and then select Plugins.

  2. On the Plugins tab, search for and install the Altinity plugin for ClickHouse.

Step 3. Create Data Source

  1. Click on the gear icon in the sidebar on the Grafana homepage, and then select Data sources.

  2. On the Data sources tab, select Add new data source.

  3. Search for and select the data source type Altinity plugin for ClickHouse.

  4. Configure the data source.

ParameterDatabendDatabend Cloud
URLhttp://localhost:8124Obtain from connection information
AccessServer (default)Server (default)
AuthBasic authBasic auth
UserFor example, rootObtain from connection information
PasswordEnter your passwordObtain from connection information
AdditonalSelect Use POST method to send queriesSelect Add CORS flag to requests
  1. Click Save & test. If the page displays "Data source is working", it indicates that the data source has been successfully created.
Did this page help you?