---
title: "Grafana integration for LuumenAI"
url: "https://www.luumen.ai/integrations/grafana/"
entity: SoftwareIntegration
category: "Monitoring & observability"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Grafana integration for LuumenAI

Read Grafana health, rings, and dashboard data, then push log records with approval

## What LuumenAI can do with Grafana

LuumenAI connects to Grafana with an API token and exposes 11 tools (9 read-only · 2 write). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 11 tools (9 read-only · 2 write)
- Plan: available on all plans
- Category: Monitoring & observability

## About Grafana with LuumenAI

Connect Grafana and your agent can check server health, inspect Loki and Mimir ring status, read license state, and query panels on public dashboards for real numbers during an incident. When it needs to write, such as sending OTLP log records into Loki, it shows the payload first and waits for your approval. Luumen authenticates with a bearer token.

## Example tools

Read-only (9 in total):

- `GRAFANA_GET_DISTRIBUTOR_HA_TRACKER` — Retrieve distributor HA tracker status.
- `GRAFANA_GET_HEALTH` — Check Grafana server health and database connectivity.
- `GRAFANA_GET_INDEX_GATEWAY_RING` — Retrieve the index gateway hash ring status from Grafana Loki.
- `GRAFANA_GET_OVERRIDES_EXPORTER_RING` — Retrieve the overrides-exporter hash ring status as an HTML page.
- `GRAFANA_GET_RULER_RING` — Retrieve the ruler ring status from Grafana Mimir.
- `GRAFANA_GET_STATUS` — Check if a valid Grafana Enterprise license is available.
- `GRAFANA_GET_STORE_GATEWAY_TENANTS` — Retrieves store gateway tenants.
- `GRAFANA_QUERY_PUBLIC_DASHBOARD` — Query a panel on a public Grafana dashboard to retrieve time-series data and metrics.

Write and destructive (2 in total, approval required by default):

- `GRAFANA_CREATE_OTLP_V1_LOGS` — Create OTLP v1 logs in Grafana Loki.
- `GRAFANA_POST_ACS` — Perform SAML Assertion Consumer Service (ACS) operation.

## Frequently asked questions

### How does LuumenAI connect to Grafana?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Grafana on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default. Administrators configure that per tool.

### Is there an audit trail?

Every call to Grafana — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/grafana/