# Create a Grafana dashboard

{% hint style="info" %}
The following guide explains how to build dashboards within the groundcover platform using our fully integrated Grafana interface. To learn how you can create dashboards using Grafana Terraform, follow [this guide](https://docs.groundcover.com/use-groundcover/embedded-grafana/embedded-grafana-dashboards/build-alerts-and-dashboards-with-grafana-terraform-provider).
{% endhint %}

A dashboard is a great tool for visually tracking, analyzing, and displaying key performance metrics, which enable you to monitor the health of your infrastructure and applications.

### Creating a new dashboard

1️⃣ Go to the *Dashboards* tab in the groundcover app, and click **New** and then **New Dashboard.**

2️⃣ Create your first panel by clicking **Add a new panel**.

3️⃣ In the New panel view, go to the **Query** tab.

4️⃣ Choose your data source by pressing the `-- Grafana --` on the data source selector. You would see your the metrics collected from each of your clusters an a Prometheus data source called <mark style="color:orange;">`Prometheus`</mark>`@`<mark style="color:blue;">`<cluster-name>`</mark>

5️⃣ Create your first Query in the PromQL query interface.

{% hint style="info" %}
Learn more about [Grafana panels](https://grafana.com/docs/grafana/v8.4/panels/) and [PromQL queries](https://prometheus.io/docs/prometheus/latest/querying/basics/) to improve your skills.\
For any help in creating your custom dashboard don't hesitate to [join our Slack support channel](https://www.groundcover.com/join-slack).
{% endhint %}

{% hint style="info" %}
**Tips:** \\

* Learn more about the supported metrics you can use to build dashboards in the [#infrastructure-metrics](https://docs.groundcover.com/capabilities/infrastructure-monitoring#infrastructure-metrics "mention") section under [infrastructure-monitoring](https://docs.groundcover.com/capabilities/infrastructure-monitoring "mention") and [application-metrics](https://docs.groundcover.com/capabilities/application-performance-monitoring-apm/application-metrics "mention") page.\\
* groundcover has a set of example dashboards in the *Dashboards by groundcover* folder which can get you started.\
  \
  These dashboard are read-only but you can see the PromQL query behind each panel by right-clicking the panel and then **Explore**\
  ![](https://2771001740-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUHgqKYgCiRKdOpWQdi52%2Fuploads%2Fgit-blob-611b534ecdfd35d333aa8f130ddfab2ad5e6477e%2Fimage.png?alt=media)\\
  {% 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/embedded-grafana/embedded-grafana-dashboards/create-a-dashboard.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.