---
title: "Supabase integration | Grafana Cloud documentation"
description: "Learn about Supabase Grafana Cloud integration."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# Supabase integration for Grafana Cloud

Supabase is an easy-to-use, open-source managed Postgres with integrated backend services. By integrating Supabase with Grafana Cloud, users gain monitoring capabilities for Supabase performance and operations. The included dashboard offers a comprehensive overview of Supabase performance, supplemented with Postgres metrics.

## Before you begin

You need a Supabase Secret API key (`sb_secret_...`). You can create/copy it in [Project Settings → API Keys](https://supabase.com/dashboard/project/_/settings/api-keys). For more context, refer to the [Supabase API key Documentation](https://supabase.com/docs/guides/api/api-keys).

## Install the Supabase integration for Grafana Cloud

1. In your Grafana Cloud stack, click **Connections** in the left-hand menu.
2. Find and select the **Supabase** tile to open the integration.
3. Follow the steps outlined on the **Configuration** page to configure scrape jobs, which pull the data from Supabase.
   
   1. Give your scrape job a descriptive name like `production-eu-central-1`
   2. Set your **Project ID** and enter the service account API key
   3. Test the connection and save the scrape job
4. Once scrape jobs are configured, click **Install** to add the prebuilt dashboards to your Grafana Cloud instance.

## Configuration

The Supabase integration works by periodically scraping the [Supabase Metrics API](https://supabase.com/docs/guides/telemetry/metrics) for metrics. You can set up multiple scrape jobs in one Grafana Cloud instance. This can be useful, if you want to monitor multiple projects in a single instance.

After installation, visit the Supabase Project dashboard to check the status of your scrape job or explore your metrics.

## Dashboards

The Supabase integration installs the following dashboard in your Grafana Cloud instance.

- Metrics endpoint scrape overview
- Supabase Project

**Screenshot of the Supabase Grafana dashboard**

## Changelog

md ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```md
# 1.2.0 - May 2026

* Add scrape endpoint diagnostics dashboard

# 1.1.0 - March 2026

* Update dashboard to match upstream

# 1.0.0 - July 2024

* Initial release
```