Plugins 〉ITRS Group Obcerv

Data Source
commercial

ITRS Group Obcerv

  • Overview
  • Installation
  • Related content

ITRS Group Obcerv data source for Grafana

Datasource Usage

Configure the data source

  1. Go to Configuration > Data sources section

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

ITRS Group Obcerv Settings

FieldDescription
Obcerv APIHost and Port of the Obcerv REST API, i.e. https://local.itrslab.com/obcerv-app-api-gateway
Skip tls verificationIf you want to skip the TLS verification

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

FieldDescription
AliasDisplayed in the legend to identify a time serie
MetricThe name of the metric
FilterFilters will be available for auto-completion when composing a query, they are in the form attribute/dimension="value". For example pod="collection-agent-sx6cv"
Group byDimensions or attributes to group by the results
BucketsUsed to populate the Buckets in BucketRequest
Bucket functionUsed to populate the Function in BucketRequest
ForecastIf enabled, returns the forecast of the selected metric. Please note that it only works if the filter returns only one metric
  • 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.

Templates and variables

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

Required fields:

General

FieldValue
NameVariable name, this name will be used in the data source to refer to the variable with the $ symbol in front
TypeQuery

Query Options

FieldValue
Data sourceITRS Group Obcerv
Querysyntax: {"name":"dimension-or-attribute"}, example: { "name": "container" }
  • 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 $preffix. 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

Installing ITRS Group Obcerv on Grafana Cloud:

For more information, visit the docs on plugin installation.