> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ewake.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Grafana

> Connect Grafana to let ewake query your dashboards, metrics, and logs for incident correlation.

<Info>
  **What you'll get:** ewake can query your Grafana instance to retrieve metrics and correlate them with alerts and deployment events, without navigating dashboards manually.
</Info>

***

## Prerequisites

* A Grafana instance (Cloud or self-hosted)
* Admin access to create a Service Account

***

## Configuration

<Steps>
  <Step title="Create a Service Account in Grafana">
    In Grafana, go to **Administration** → **Service Accounts** → click **Add service account**.

    Set the role to **Viewer**, ewake only needs read access.

    Once the account is created, click **Add service account token** → copy the token immediately.

    <Note>
      Copy the token now, you won't be able to see it again after closing the modal.
    </Note>
  </Step>

  <Step title="Open the Grafana integration in ewake">
    In your ewake dashboard, go to **Integrations** → **Grafana** → click **Configure**.

    <img src="https://mintcdn.com/ewakeai/M1QmRrA-jDM2VkcE/images/integrations/observability/grafana/grafana-connect-modal.png?fit=max&auto=format&n=M1QmRrA-jDM2VkcE&q=85&s=5525dde8e7dfeff37563de9d3366702b" alt="Connect to Grafana modal in ewake" style={{ maxHeight: "320px", objectFit: "cover", objectPosition: "top", borderRadius: "8px" }} width="974" height="372" data-path="images/integrations/observability/grafana/grafana-connect-modal.png" />
  </Step>

  <Step title="Enter your credentials">
    | Field                | Value                                                          |
    | -------------------- | -------------------------------------------------------------- |
    | **Grafana Base URL** | Your Grafana instance URL (e.g. `https://grafana.example.com`) |
    | **Grafana API Key**  | The token generated in Step 1                                  |
  </Step>

  <Step title="Test and save">
    Click **Test Configuration** to verify the connection, then click **Save**.

    <Check>
      Grafana is connected. Ewake can now query your metrics and dashboards.
    </Check>
  </Step>
</Steps>

***

<Note>
  Ewake only requires **read-only** access to Grafana. It never modifies dashboards or data sources.
</Note>