Guides on Grafana Labs

Query metrics with Prometheus

Thu, 23 Apr 2026 10:03:11 +0200

Query metrics with Prometheus

Use the Grafana MCP server so your AI assistant can run PromQL queries against a Prometheus datasource in Grafana. You can run instant or range queries and discover metric and label names and values.

What you’ll achieve

You ask your assistant to check a metric or run a PromQL expression; the assistant uses the server’s Prometheus tools to run the query and return results (or describe available metrics and labels).

Before you begin

The server set up and configured with access to Grafana.
A Prometheus datasource configured in Grafana. The service account must have datasources:query and scope for that datasource (for example, datasources:uid:<uid>).

Run a PromQL query

In your MCP client, ask the assistant to query Prometheus. For example, you might say “What is the current value of up for the Prometheus datasource?” or “Run this PromQL: rate(http_requests_total[5m]).” The assistant uses the server’s Prometheus query tool with the datasource UID and your time range. You can request instant queries (single value) or range queries (series over time).

Discover metrics and labels

Ask the assistant to list metric names, label names, or label values for a given selector. The server exposes tools that call the Prometheus API (metric metadata, label names, label values). Use these to explore what’s available before writing PromQL.

Next steps

Query logs with Loki for log and LogQL use cases.
Run a dashboard panel query to execute a panel’s query from the MCP server.

Query logs with Loki

Thu, 23 Apr 2026 10:03:11 +0200

Query logs with Loki

Use the Grafana MCP server so your AI assistant can run LogQL log and metric queries against a Loki datasource in Grafana. You can also list label names and values and retrieve log patterns.

What you’ll achieve

You ask your assistant to search logs or run a LogQL expression; the assistant uses the server’s Loki tools to run the query and return log lines or metric values. You can also explore labels and patterns.

Before you begin

The server set up and configured with access to Grafana.
A Loki datasource configured in Grafana. The service account must have datasources:query and scope for that datasource.

Run a LogQL query

In your MCP client, ask the assistant to query Loki. For example, “Show me recent error logs from the Loki datasource” or “Run this LogQL: {job="myapp"} |= "error".” The assistant uses the server’s Loki query tool with the datasource UID, time range, and limit. You can run log queries (streams of log lines) or metric queries (counts, rates, etc.).

Explore labels and patterns

Ask the assistant to list label names or label values for a selector, or to retrieve detected log patterns. These tools help you discover what’s in your logs before writing LogQL.

Next steps

Query metrics with Prometheus for PromQL use cases.
Search and inspect dashboards to find and explore dashboards.

Search and inspect dashboards

Thu, 23 Apr 2026 10:03:11 +0200

Search and inspect dashboards

Use the Grafana MCP server so your AI assistant can search for dashboards and inspect them (summaries, panel queries, or specific properties) without pulling full dashboard JSON. That keeps context window use under control.

What you’ll achieve

You ask your assistant to find dashboards or to summarize a dashboard, list its panels and queries, or extract specific fields. The assistant uses search, get summary, get panel queries, or get property tools as appropriate.

Before you begin

The server set up and configured with access to Grafana.
The service account must have dashboards:read and scope for the dashboards you care about.

Search for dashboards

Ask the assistant to search for dashboards by title or other criteria. The server’s search tool returns matching dashboards with metadata. Use this to find the UID or folder of the dashboard you want.

Get a dashboard summary or panel queries

When you need an overview of a dashboard without the full JSON, ask for a dashboard summary. You get title, panel count, panel types, variables, and similar metadata. To see what each panel queries, ask for panel queries: the assistant uses the tool that returns panel title, query string, and datasource UID and type for every panel.

Get specific properties with JSONPath

When you only need certain parts of a dashboard (for example, one panel’s config), ask the assistant to use get_dashboard_property with a JSONPath expression (for example, $.panels[0].title). That fetches only the requested data and avoids loading the full dashboard.

Next steps

Generate deeplinks to Grafana to get shareable links to dashboards and panels.
Manage alert rules to create or update alert rules from your assistant.

Manage alert rules

Thu, 23 Apr 2026 10:03:11 +0200

Manage alert rules

Use the Grafana MCP server so your AI assistant can list and fetch alert rules, create or update rules, delete rules, and inspect notification policies and contact points.

What you’ll achieve

You ask your assistant to show firing alerts, add a new alert rule, change a rule’s condition or labels, or list contact points. The assistant uses the server’s alerting tools with the permissions you’ve granted.

Before you begin

The server set up and configured with access to Grafana.
The service account must have alert.rules:read (and alert.rules:write for create/update/delete) and appropriate folder scopes. For routing (contact points, policies), alert.notifications:read is required.

List and inspect alert rules

Ask the assistant to list alert rules or get details for a rule by UID. You can filter by folder or labels. The assistant uses the alerting tools to return rule title, state (firing, pending, normal), and configuration.

Create or update alert rules

Ask the assistant to create a new alert rule or update an existing one. You provide (or the assistant infers) the folder UID, condition, queries, labels, and annotations. The service account needs write permissions and scope for the folder. The assistant uses the server’s create/update alert rule tool.

Manage contact points and routing

Ask the assistant to list contact points or notification policies. The server exposes tools for Grafana-managed routing; for Alertmanager datasources, it can query receivers. Use this to see where alerts are sent or to describe routing before changing it (actual routing changes may require the Grafana UI or API outside MCP).

Next steps

Introduction for RBAC and permissions.
Search and inspect dashboards to find dashboards that use alerts.

Generate deeplinks to Grafana

Thu, 23 Apr 2026 10:03:11 +0200

Generate deeplinks to Grafana

Use the Grafana MCP server so your AI assistant can generate correct deeplink URLs to dashboards, panels, and Grafana Explore. The server uses the Grafana API to build URLs so you get working links instead of guessed paths.

What you’ll achieve

You ask your assistant for a link to a dashboard, a specific panel, or Explore with a given datasource (and optional time range). The assistant uses the server’s deeplink tool and returns a URL you can open or share.

Before you begin

The server set up and configured with access to Grafana.
No extra RBAC is required for generating links (read-only URL generation).

Get dashboard and panel links

Ask the assistant to generate a link to a dashboard by UID, or to a specific panel (dashboard UID and panel ID). You can request a time range (for example, last hour) so the link opens with that range. The assistant uses the server tool and returns a URL like http://localhost:3000/d/<uid>?viewPanel=<id>&from=now-1h&to=now.

Get Explore links

Ask for a link to Grafana Explore with a specific datasource (by UID). Optionally specify time range or other query parameters. The assistant returns a URL that opens Explore with that datasource and options pre-filled.

Next steps

Search and inspect dashboards to find dashboard and panel IDs.
Query metrics with Prometheus or Query logs with Loki to work with datasources.

Run a dashboard panel query

Thu, 23 Apr 2026 10:03:11 +0200

Run a dashboard panel query

Use the Grafana MCP server to run a dashboard panel’s query (the same query the panel uses) with a custom time range and variable overrides. This is useful when you want the assistant to “run what this panel runs” without writing PromQL or LogQL yourself.

What you’ll achieve

You point the assistant at a dashboard and panel; the assistant uses the server’s run-panel-query tool to execute that panel’s query and return the result (or an error if the query or datasource is invalid).

Before you begin

The server set up and configured with access to Grafana.
The run-panel-query tool must be enabled (it’s disabled by default). Add runpanelquery to Enable and disable tools.
The service account must have dashboards:read and datasources:query with scope for the dashboard and the datasource the panel uses.

Run the panel query

Ask the assistant to run the query for a specific panel on a dashboard. Provide (or let the assistant look up) the dashboard UID and panel ID. You can specify a time range (for example, last 1 hour) and variable overrides so the query runs with the same logic as the panel but with your chosen parameters. The assistant calls the server’s run-panel-query tool and returns the result.

Next steps

Query metrics with Prometheus or Query logs with Loki to run custom PromQL or LogQL.
Search and inspect dashboards to find panel IDs and datasources.

Use Grafana Incident and Sift

Thu, 23 Apr 2026 10:03:11 +0200

Use Grafana Incident and Sift

Use the Grafana MCP server so your AI assistant can work with Grafana Incident (list, create, get, add activities) and Sift (list investigations, get analyses, find error patterns in logs, find slow requests). These features use Grafana basic roles: Viewer for read, Editor for write.

What you’ll achieve

You ask your assistant to list or create incidents, add a note to an incident, list Sift investigations, or run a Sift analysis (for example, find elevated error patterns in Loki or slow requests in Tempo). The assistant uses the server’s Incident and Sift tools.

Before you begin

The server set up and configured with access to Grafana.
Grafana Incident (and Sift, if used) available on your instance. The service account must have at least the Viewer role for read-only operations; Editor role for creating incidents or running Sift analyses that create investigations.

Work with incidents

Ask the assistant to list incidents (optionally filtered by status), get one incident by ID, create a new incident (title, severity, room prefix, etc.), or add an activity (note) to an incident. The assistant uses the server’s Incident tools. Creating incidents or adding activities requires Editor role.

Work with Sift investigations

Ask the assistant to list Sift investigations, get one by UUID, or get a specific analysis from an investigation. For proactive analysis, ask to find error patterns in logs (Loki) or find slow requests (Tempo); the server starts a Sift investigation and returns the results. These “find” operations create investigations and require Editor role.

Next steps

Introduction for roles and permissions.
Manage alert rules for alerting from the MCP server.

Query metrics with InfluxDB

Thu, 23 Apr 2026 14:05:09 +0000

Query metrics with InfluxDB

Use the Grafana MCP server so your AI assistant can run InfluxDB queries against an InfluxDB datasource in Grafana. The server supports both InfluxQL (v1.x) and Flux (v2.x); the dialect is inferred from the datasource’s configured version or can be set explicitly.

What you’ll achieve

You ask your assistant to query an InfluxDB-backed metric; the assistant uses the server’s InfluxDB query tool to post the query through Grafana’s datasource proxy and return the points. The server is a thin shim over Grafana’s /api/ds/query endpoint, so Grafana handles all protocol details for InfluxDB v1 and v2.

Before you begin

The server set up and configured with access to Grafana.
The InfluxDB tool category must be enabled (it’s disabled by default, like the other optional datasource tools). Add influxdb to Enable and disable tools.
An InfluxDB datasource configured in Grafana. The service account must have datasources:query and scope for that datasource (for example, datasources:uid:<uid>).

Run a query

In your MCP client, ask the assistant to query InfluxDB. For example, “What was the mean CPU usage on the host server1 in the last hour?” or “Run this Flux: from(bucket: \"metrics\") |> range(start: -1h) |> filter(fn: (r) => r._measurement == \"cpu\").” The assistant uses the server’s query_influxdb tool with the datasource UID, query string, and time range.

If the datasource is configured for InfluxDB v2 (Flux), pass a Flux query. If it’s configured for v1 (InfluxQL), pass an InfluxQL query. You can override the dialect explicitly by setting dialect to "flux" or "influxql".

Run a panel’s query from a dashboard

If a dashboard you care about already contains the InfluxDB panel you want, use run_panel_query instead of writing the query yourself. The MCP server fetches the dashboard, extracts the panel’s query and queryType, substitutes any template variables, and executes the query against the configured datasource. This is the fastest path from “what does this panel show?” to actual data.

Discover what’s in a bucket or database

The server does not expose dedicated measurement- or tag-listing tools. Instead, run discovery queries via query_influxdb:

Flux (v2): from(bucket: "my-bucket") |> range(start: -1h) |> limit(n: 5) to see available fields and tags on recent points.
InfluxQL (v1): SHOW MEASUREMENTS, SHOW TAG KEYS FROM "cpu", SHOW FIELD KEYS FROM "cpu".

Use get_query_examples with datasourceType: "influxdb" to see more starter queries for both dialects.

Next steps

Query metrics with Prometheus for PromQL use cases.
Run a dashboard panel query to execute a panel’s query from the MCP server.