ITRS Analytics data source for Grafana

Prerequisites

The ITRS Analytics datasource connects exclusively to the API Gateway. It does not call individual platform services directly.

• The API Gateway must be deployed and expose Public API v2 (/api/v2/*).
• Grafana 12.0.0 or later is required.

Authentication is handled by Grafana: users log in via the platform IAM (OAuth), and the datasource uses that session. The plugin does not have separate credentials.

Datasource Usage

Configure the data source

1. Go to Configuration > Data sources section

2. Click on "Add data source" and look for "ITRS Analytics" one and select it

ITRS Analytics Settings

You can also click on the Default switch on the top of the screen if you want it to appear as default datasource.

Click on Save and test to save the configuration

(You can see the official Grafana doc to add a datasource here)

Query the data source

At the top of the panel query editor, use the Mode radio to select Metrics or Logs. Metrics mode is the default when no mode is set.

Use a time series, stat, or table panel for metrics queries. Use Grafana's Logs panel for log queries.

Metrics mode

• Note: Stat visualization, to use status metrics on "Options Panel", "Value options" section, select in Fields drop-down All fields in order to display not only numeric fields.

Logs mode

Selecting Logs shows a Search radio with Simple or Advanced options.

Simple search

Advanced search

Templates and variables

You can add variables to your dashboard. To add a new ITRS Analytics query variable, go to dashboards settings, and click on Add variable in Variables section.

Variables apply to metrics query fields (filter, group by, metric lookups). Logs mode uses the visual editor rather than JSON variable queries.

Required fields:

General

Query Options

• Note: Selection options, check multi-value switch if you want to choose more than one value for the variable

If you want to see a preview of the values, click on Update.

Then you can filter the widgets you want to depend on the variable using the name with a $:

{ "name": "$<variable-name>" }

And you will be able to use the variable in your dashboard.

Variables with filter

The variables can be filtered by another variable, a dimension or an attribute. The syntax to populate variables with a filter is:

{ "name": "<dimension-or-attribute>", "filter": [{ "name": "<dimension-or-attribute>", "value": "$variableName1" }] }

The filter is a list of objects with the fields name and value. The name must be an attribute or dimension name, the value can be a specific value or the name of another variable with the $ prefix. For example, if it exists a variable named kubecontainer, the query could be:

{ "name": "pod", "filter": [{ "name": "container", "value": "$kubecontainer" }] }

This will allow variable chaining so the values of some variables can be used to filter other dependant variables.

Some useful links with information about query variables:

Add a query variable

Variable syntax

Templates and variables