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

# Grafana Cloud

> Connect Rootly AI to your Grafana Cloud stack — metrics, logs, dashboards, and alerts — with a single-field setup.

## Overview

Connecting **Grafana Cloud** lets Rootly AI query your Grafana Cloud stack during investigations — pulling metrics, logs, profiles, dashboards, and alerts. You provide your stack URL, authorize Rootly AI in Grafana's consent screen, and the integration is live.

<Note>
  If you self-host Grafana instead of using Grafana Cloud, use the [Grafana Managed integration](/ai/connectors/grafana-managed). This page is only for the managed Grafana Cloud offering.
</Note>

***

## Before You Start

You'll need:

* **A Grafana Cloud account** with permission to authorize third-party apps against your stack.
* **Your Grafana Cloud stack URL** — the base URL of your stack (e.g., `https://your-stack.grafana.net`). Find it by logging in to Grafana Cloud and copying the URL of the main dashboard.

That's it. No API keys, no service accounts, no self-hosted infrastructure.

***

## Connecting

Open **Configuration → AI → Connectors** and click **Connect** on the Grafana Cloud card.

<ParamField path="Grafana Cloud Stack URL" type="string" required>
  Your stack's base URL. Must be a Grafana Cloud-hosted URL (`*.grafana.net`).

  ```
  https://your-stack.grafana.net
  ```
</ParamField>

Click **Save**. Rootly redirects to Grafana's authorization page — sign in to Grafana Cloud (if not already signed in), review the requested access, and click **Authorize Rootly AI**. Grafana sends you back to Rootly, and the card flips to **Connected**.

***

## What Rootly AI Can Read

Once connected, Rootly AI can query your Grafana Cloud stack for:

* **Metrics** from any Prometheus-compatible data source connected to Grafana Cloud (including Grafana Cloud's own Prometheus).
* **Logs** from Loki data sources.
* **Traces** from Tempo data sources.
* **Dashboard configurations** — Rootly AI can look up which dashboards exist and read their panel queries.
* **Alerts and alert rules** — including firing state, alert history, and rule definitions.
* **Profiles** from Pyroscope data sources (if attached to your stack).

Rootly AI can only see data your authorizing Grafana Cloud user has access to. If you have Team-scoped folders in Grafana, Rootly AI's read access matches your team membership.

***

## Best Practices

* **Authorize with a service-oriented account, not a personal one.** If a personal Grafana account leaves your organization, the integration breaks silently. A shared service-oriented account (or an admin account with stable membership) survives staff turnover.
* **Review the requested access before authorizing.** Grafana's consent screen shows exactly what Rootly AI is asking for. If any request looks broader than needed, don't authorize — reach out to Rootly support first.
* **Reconnect after Grafana stack migrations.** If you migrate to a new Grafana Cloud stack, the old integration still references the old stack. Disconnect and reconnect against the new stack URL.
* **Test with `/rootly test`.** Declare a test incident after connecting and confirm Rootly AI can pull Grafana signals during the investigation.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authorization fails or redirects with an error" icon="triangle-exclamation">
    Two common causes: (1) your Grafana Cloud account doesn't have permission to authorize third-party apps — check with a Grafana admin; (2) the stack URL you entered doesn't match a valid Grafana Cloud stack — verify it ends in `.grafana.net` and that you can log in to it directly in a browser.
  </Accordion>

  <Accordion title="The card shows Connected but Rootly AI returns 'insufficient permissions' from Grafana" icon="lock">
    The authorization is valid but your Grafana user's role doesn't include read access to whatever Rootly AI is querying. Grafana Cloud enforces role-based access per data source — check your role in Grafana's team/permissions settings.
  </Accordion>

  <Accordion title="Rootly AI queries succeed but return empty results for known-good queries" icon="magnifying-glass">
    Data-source-level access. Even with the right Grafana role, some data sources (especially Team-scoped folders) require explicit permissions. Verify by logging in to Grafana as the same user and running the query directly — if you see the same empty results, the data-source access is the issue.
  </Accordion>

  <Accordion title="After a Grafana Cloud plan change, queries started failing" icon="credit-card">
    Grafana Cloud plans include different data-source quotas and integration access. If you downgraded a plan and Rootly AI's integration is now off your plan, queries return errors. Check your plan's inclusions in Grafana Cloud settings.
  </Accordion>
</AccordionGroup>

***

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Do I need to run any extra software for Grafana Cloud?" icon="server">
    No. Grafana Cloud is fully managed — you don't run anything. Only the Grafana Managed integration requires you to deploy any additional piece yourself.
  </Accordion>

  <Accordion title="Can I connect multiple Grafana Cloud stacks?" icon="chart-line">
    One Grafana Cloud stack per Rootly team currently. If you operate multiple stacks, connect the one that hosts most of your observability signals. Multi-stack support is on the roadmap.
  </Accordion>

  <Accordion title="Does the authorization expire?" icon="clock">
    The authorization refreshes automatically as long as the underlying Grafana Cloud user account remains active and you haven't revoked Rootly AI from the Grafana side. If either happens, the integration fails on the next query and needs re-authorization.
  </Accordion>

  <Accordion title="Does the integration count against Grafana Cloud query quotas?" icon="gauge-high">
    Yes. Rootly AI's queries count as normal Grafana API calls against your plan's quotas. Investigation-driven volume is low in practice — a few queries per investigation.
  </Accordion>

  <Accordion title="Can I audit what Rootly AI has queried in Grafana Cloud?" icon="file-lines">
    Yes. Grafana Cloud's audit logs record all API activity, including calls made by third-party apps. Filter by Rootly AI to see the full history.
  </Accordion>
</AccordionGroup>

***

## Related Pages

<CardGroup cols={3}>
  <Card title="Connectors Overview" icon="sparkles" href="/ai/connectors/overview">
    The full list of Connectors and how they fit together.
  </Card>

  <Card title="Grafana Managed" icon="chart-line" href="/ai/connectors/grafana-managed">
    The self-hosted-Grafana counterpart.
  </Card>

  <Card title="Grafana Cloud docs" icon="up-right-from-square" href="https://grafana.com/docs/grafana-cloud/">
    Grafana Labs' own documentation for Grafana Cloud.
  </Card>
</CardGroup>