Using groundcover datasources in a Self-hosted Grafana

Exposing Data Sources for Managed inCloud Setup

groundcover inCloud Managed supports integration with customer owned Grafana by exposing Prometheus and Clickhouse data sources.

Requirements

Tenant api-key

The groundcover tenant API KEY is required for configuring the data source connection.

The key can be obtained by running: groundcover auth get-datasources-api-key

For this example we will use the key EXAMPLEAAAABBBBCCCCDDDDEEEEFFFF

inCloud site address

To add groundcover as a Data Source for your internal Grafana you will need to know the groundcover inCloud site address which can be obtained from your groundcover integration manager.

For this example we will use site incloud-site.example.com

Setup

Prometheus

Configure Grafana prometheus Data Source by following these steps logged in as Grafana Admin.

1. Connections > Data Sources > + Add new data source

2. Pick Prometheus

   1. Name: groundcover-prometheus

   2. Prometheus server URL: https://incloud-site.example.com/datasources/prometheus

   3. Customer HTTP Headers > Add Header

      1. Header: apikey

      2. Value: EXAMPLEAAAABBBBCCCCDDDDEEEEFFFF

   4. Performance

      1. Prometheus type: Prometheus

      2. Prometheus version: > 2.50.x

3. Click "Save & test"

"Successfully queried the Prometheus API" means the integration was configured correctly.

ClickHouse

Configure Grafana ClickHouse Data Source by following these steps logged in as Grafana Admin.

1. Connections > Data Sources > + Add new data source

2. Pick ClickHouse

   1. Name: groundcover-clickhouse

   2. Server

      1. Server address: incloud-site.example.com

      2. Server port: 443

      3. Protocol: HTTPS

      4. Secure Connection: SELECTED

   3. Credentials

      1. Username: LEAVE BLANK

      2. Password: EXAMPLEAAAABBBBCCCCDDDDEEEEFFFF

   4. Additional Properties

      1. Default database: groundcover

3. Click "Save & test"

"Data source is working" means the integration was configured correctly.