Infinity data source plugin for Grafana

The Infinity data source is a universal plugin for pulling data from various systems into Grafana using existing REST APIs. It’s Grafana’s go-to plugin for cases when a native plugin doesn’t exist yet.

The following resources will help you get started with the Infinity data source:

Key capabilities

The Infinity data source supports:

Multiple data formats: Query JSON, CSV, TSV, XML, and GraphQL endpoints.
Flexible data manipulation: Transform data with JQ, JSONata, and UQL.
Various authentication methods: Basic, Bearer token, API key, OAuth passthrough, OAuth2 client credentials, OAuth2 JWT, AWS/Azure/GCP authentication, and Digest authentication.
Backend features: Alerting, recorded queries, shared dashboards, and query caching (in backend parsing mode).
Grafana integrations: Node graph panel, annotations, and template variables.

Before you begin

Before you configure the Infinity data source, you need:

Grafana version 11.6 or later
Network access from Grafana to your target API endpoints
Appropriate credentials for authenticated endpoints (API keys, OAuth credentials, etc.)

Supported data formats

This data source supports the following formats:

JSON - Query JSON APIs
CSV / TSV - Query CSV, TSV, or any delimited content
XML / HTML - Query XML and HTML endpoints
GraphQL - Query GraphQL APIs

Known limitations

Grafana features such as alerting, shared dashboards, recorded queries, and enterprise query caching are only available when using a backend parser (JSONata or JQ).
Infinity is not designed for handling large amounts of data. When inlining data, ensure snippets are less than 1MB in size.
For a list of all known issues, refer to GitHub issues.

Additional resources

Once you have configured the Infinity data source, you can:

Use Explore to run ad-hoc queries.
Configure and use template variables for dynamic dashboards.
Add transformations to process query results.

Query with the Grafana CLI

You can query this data source from the command line and from AI coding agents using the Grafana CLI, gcx. gcx gives you and your agent structured, terminal-based access to your Grafana data sources, which is useful for automation and agent-driven investigations.

gcx supports Grafana Cloud and Grafana OSS or Enterprise v12 and later. Before you query, install and authenticate gcx. Refer to the gcx CLI documentation for installation, configuration, and the full command reference.

For example, to query a pre-configured Infinity data source, use gcx datasources infinity query:

gcx datasources infinity query -d <DATASOURCE_UID> '$.items' -o json

Replace <DATASOURCE_UID> with the UID of your Infinity data source. gcx reads the URL, type, method, and headers from the saved data source configuration. The optional selector expression ($.items for JSON, or an XPath for XML or HTML) narrows the returned data.

Get started

Watch this video to get started with the Grafana Infinity data source plugin:

Give it a try using Grafana Play

With Grafana Play, you can explore and see how it works, learning from practical examples to accelerate your development. This feature can be seen on Infinity plugin demo.

Try it