Overview

This data source plugin enables data comparison capabilities by supporting queries from multiple data sources. It allows you to use custom time shifts to display data from different time ranges within a single graph.

Key features:

• Compatible with Grafana 11/12/13+
• Resolves issues with undefined data points
• Introduces support for timeShift aliases
• Supports Grafana Alerting through backend execution

Quick start

Step 1. Add the real target datasource you want to compare, such as Elasticsearch. CompareQueries does not store metrics by itself; it runs queries against this target datasource.

Step 2. Create a datasource of type CompareQueries.
Grafana -> Connections -> Data sources -> Add new data source -> search compare.

Step 3. Configure CompareQueries datasource settings.

• Authentication (Optional) defaults to No Authentication
• Switch to Basic authentication only when backend or alerting requests fail authentication
• Fill Service Account and optional Grafana URL only in that case

Step 4. Create a dashboard panel and set panel datasource to -- Mixed --.

Step 5. Add a query row and select CompareQueries as that row's datasource.

Step 6. Pick Target Datasource inside CompareQueries, build target query inline, and add time shift rows (Amount like 1d, 1w, etc.).

Legacy RefId usage (Grafana < 13 existing dashboards only)

Use this only if you are on Grafana versions below 13 and already have dashboards using the old CompareQueries RefId workflow.

• Query A: build normal source query (e.g. Elasticsearch)
• Query B: use CompareQueries and reference Query A by RefId
• Keep panel datasource as -- Mixed --

For Grafana 13+, use Step 4 recommended flow instead: select Target Datasource inside CompareQueries.

Grafana Alerting (2.1.0+)

Alerting uses backend execution. Alert rules do not use the panel -- Mixed -- datasource flow. Configure CompareQueries directly with Target Datasource, Time shift, and query inline.

• Default datasource auth mode is No Authentication.
• If backend or alerting requests fail authentication, switch to Basic authentication.
• In Basic authentication, configure Service Account token and (optionally) Grafana URL.

Reference alert rule setup (query + condition):