View as Markdown
Grafana icon

Grafana ACTION

Query Data Source

Execute a query against any configured data source. Use List Data Sources first to discover available data sources and their UIDs. The query language depends on the data source type:

Prometheus (PromQL): rate(http_requests_total[5m]), sum by (status_code) (rate(http_requests_total[5m]))

Loki (LogQL): {app="myapp"} |= "error", rate({app="myapp"}[5m])

Note: This tool uses the expr query field, which works with Prometheus and Loki. For SQL-based data sources (MySQL, Postgres) or InfluxDB, the query field name differs and may not work with this tool.

Time range defaults to last 1 hour. Use from and to for custom ranges (supports relative: now-24h, now-7d, or epoch milliseconds).

  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Grafana account once, then configure and run Query Data Source from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "grafana-query-data-source",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    grafana: { authProvisionId: "apn_xxxxxxx" },
    datasourceUid: "Data Source UID",
    expression: "Query Expression",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Query Data Source inputs
Property Type Description
datasourceUid Data Source UID string
The UID of the data source to query. Use List Data Sources to discover available data sources.
Required
expression Query Expression string
The query expression in the data source's native language (PromQL, LogQL, SQL, Flux, etc.).
Required
from From string
Start of the time range. Supports relative times like now-1h, now-24h, now-7d, or epoch milliseconds. Default: now-1h.
Optional
to To string
End of the time range. Supports relative times like now or epoch milliseconds. Default: now.
Optional
intervalMs Interval (ms) integer
Step interval in milliseconds for time-series queries.
Optional
maxDataPoints Max Data Points integer
Maximum number of data points to return. Default: 100.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
grafana-query-data-source
Version
0.0.3
App
Grafana
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes