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

groundcover [BYOC](/architecture/byoc.md) 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](/customization/customize-deployment/on-premise-deployment.md) 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](/use-groundcover/remote-access-and-apis/api-keys.md) 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.groundcover.com/use-groundcover/querying-your-groundcover-data/using-groundcover-as-a-database.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.