Using groundcover as Prometheus/Clickhouse database in a Self-hosted Grafana

Exposing Data Sources for Managed inCloud Setup

groundcover inCloud Managed exposes Prometheus data sources for programmatic access via API, and integration with customer owned Grafana instances.

Different steps are required for On-Prem deployments, contact us for additional info.

Requirements

API Key

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

You can obtain your API key from the API Keys page in the groundcover console.

For this example we will use the key API-KEY-VALUE

Setup

Prometheus

Grafana Data Source Configuration

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://app.groundcover.com/api/prometheus

   3. Customer HTTP Headers > Add Header

      1. Header: authorization

      2. Value: Bearer API-KEY-VALUE

   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.

Legacy Configuration

The following configurations are deprecated but may still be in use in older setups.

Datasources API Key

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

ClickHouse

ClickHouse datasource integration is deprecated and no longer supported for new installations.

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: ds.groundcover.com

      2. Server port: 443

      3. Protocol: HTTP

      4. Secure Connection: ON

   3. HTTP Headers

      1. Forward Grafana HTTP Headers: ON

   4. Credentials

      1. Username: Leave empty

      2. Password: API-KEY-VALUE

   5. Additional Properties

      1. Default database: groundcover

3. Click "Save & test"

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