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

groundcover [BYOC](https://docs.groundcover.com/architecture/byoc) exposes [Prometheus](https://grafana.com/grafana/plugins/prometheus/) data sources for programmatic access via API, and integration with customer owned Grafana instances.

{% hint style="warning" %}
Different steps are required for [On-Prem](https://docs.groundcover.com/customization/customize-deployment/on-premise-deployment) deployments, contact us for additional info.
{% endhint %}

## 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](https://docs.groundcover.com/use-groundcover/remote-access-and-apis/api-keys) 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"

{% hint style="info" %}
"Successfully queried the Prometheus API" means the integration was configured correctly.
{% endhint %}

## Legacy Configuration

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

### Datasources API Key

{% hint style="warning" %}
The legacy datasources API key can be obtained by running: `groundcover auth get-datasources-api-key`
{% endhint %}

### ClickHouse

{% hint style="warning" %}
ClickHouse datasource integration is deprecated and no longer supported for new installations.
{% endhint %}

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"

{% hint style="info" %}
"Data source is working" means the integration was configured correctly.
{% endhint %}