Open and composable observability platform for metrics, logs, and traces
Open and composable observability platform for metrics, logs, and traces On Nagent, Grafana is exposed as a fully-configurable developer tools integration that any agent can call — 11 actions, and BEARER_TOKEN authentication. No code is required to wire Grafana into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Grafana to automate the kinds of tasks developer tools teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Grafana into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Grafana, with input parameters and output schema. Drop these into any step of an agent built in Helix.
GRAFANA_CREATE_OTLP_V1_LOGSTool to create OTLP v1 logs in Grafana Loki. Use when you need to send OpenTelemetry Protocol logs to Grafana for ingestion and storage.
Input parameters
List of resource logs to send to Grafana Loki.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GRAFANA_GET_DISTRIBUTOR_HA_TRACKERTool to retrieve distributor HA tracker status. Use when you need to check which replica has been elected as leader for each Prometheus HA cluster.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GRAFANA_GET_HEALTHCheck Grafana server health and database connectivity. Returns 'ok' if Grafana's web server is running and can access the database. Use when you need to verify Grafana instance availability before performing operations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GRAFANA_GET_INDEX_GATEWAY_RINGTool to retrieve the index gateway hash ring status from Grafana Loki. Returns information about the state, health, and last heartbeat time of each index gateway in the ring.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GRAFANA_GET_OVERRIDES_EXPORTER_RINGTool to retrieve the overrides-exporter hash ring status as an HTML page. Use when you need to check the state, health, and heartbeat information of overrides-exporter instances. Only accessible when -overrides-exporter.ring.enabled flag is true.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GRAFANA_GET_RULER_RINGTool to retrieve the ruler ring status from Grafana Mimir. Use when you need to check the distributed hash ring topology and operational status of ruler instances.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GRAFANA_GET_STATUSTool to check if a valid Grafana Enterprise license is available. Use when you need to verify license status or availability.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GRAFANA_GET_STORE_GATEWAY_TENANTSRetrieves store gateway tenants. Returns a list of tenants that have blocks stored in the store-gateway's configured storage. Use when you need to view which tenants have data stored on a store-gateway node.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GRAFANA_POST_ACSTool to perform SAML Assertion Consumer Service (ACS) operation. Use when processing SAML authentication responses from an identity provider. This endpoint typically handles the SAML assertion and returns a redirect response (HTTP 302).
Input parameters
Optional relay state parameter for SAML authentication flow. This is typically used to maintain state between the identity provider and service provider during SAML authentication.
Base64-encoded SAML Response from the Identity Provider. This contains the SAML assertion with authentication information.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GRAFANA_QUERY_PUBLIC_DASHBOARDQuery a panel on a public Grafana dashboard to retrieve time-series data and metrics. Use when you need to fetch visualization data from a publicly shared dashboard without authentication. Returns data frames with query results for the specified time range.
Input parameters
End time for the query. Can be absolute timestamp (epoch ms) or relative time expression (e.g., 'now', 'now-1h'). Typically 'now' for current time.
Start time for the query. Can be absolute timestamp (epoch ms) or relative time expression (e.g., 'now-6h', 'now-1d', 'now-7d'). Use 'now' for current time.
Panel ID to query (numeric identifier of the panel within the dashboard)
Time interval between data points in milliseconds. Controls data aggregation granularity.
Public dashboard access token (unique identifier for the shared dashboard)
Maximum number of data points to return. Helps control query resolution and response size.
Optional base URL override for the Grafana instance hosting the public dashboard. If not provided, uses the authenticated instance URL. Useful for querying public dashboards from other Grafana instances (e.g., 'https://play.grafana.org').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GRAFANA_RETRIEVE_JWKSTool to retrieve JSON Web Key Set (JWKS) with all public keys for token verification. Use when you need to get the keys that can verify JWT tokens.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 38 agents privately built on Nagent that already use Grafana.
Build on Nagent
Connect Grafana to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Grafana, and click "Connect Now." You'll authenticate with BEARER_TOKEN — Nagent handles credential storage and refresh automatically. Once connected, Grafana is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Grafana is connected, you configure its 11 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Grafana steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Grafana event fires, the agent kicks off automatically.
Every Grafana action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Grafana ships with 11 pre-built developer tools actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Grafana together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Grafana-based workflows tailored to your business.