azeti Data Source Plug-in for Grafana - Release 1.1.2

We’re excited to release the 1.1.2 version of the azeti Data Source Plug-In for Grafana.

This release includes the fix for the azeti Data Source Plug-in not being present on the Grafana Data source dropdown.

What’s new

  • azeti Data Source Plug-in now is always present on the Grafana Data source dropdown after the plug-in configuration.

 

Installation

You can download the plugin package here (Click “Download” at the top left corner).

The contents of the zip file must be extracted to the plugins folder of the Grafana instance. This folder can be configured depending on the installation:

With Docker

When starting the container, we can mount a volume between the local filesystem and Docker’s. An example of this can be:

1 2 -v LOCAL_FOLDER_WITH_PLUGINS_DIRECTORIES:/var/lib/grafana/plugins:z \

Where LOCAL_FOLDER_WITH_PLUGINS_DIRECTORIES it’s a path in the server’s filesystem with the azeti-grafana-plugin directory.

With system’s package manager

The configuration.ini should be modified, under the paths section. Another option is to overwrite an environment variable, the structure of Grafana’s environment variables is:

GF_MAJORSECTION_MINORSECTION

In our example, the variable to overwrite would be: GF_PATHS_PLUGIN

Unsigned plugin enabled

It is very important that regardless of the method, you overwrite the environment variable that allows loading unsigned plugins with the id of the azeti plugin, in the following way:

1 2 GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=azeti-iot-platform-backend-datasource

How to connect to azeti IoT Platform

After installing, go to the data sources section of your Grafana instance. This can be found in https://YOUR_GRAFANA_DOMAIN/datasources or by navigating via the sidebar to the data sources section

Add a new data source, at the end of the page, you should be able to see the azeti IoT Platform entry.

To configure with your azeti IoT Platform, add the following values:

  • Host: hostname where you access the azeti IoT Platform i.e. http://staging.azeti.net . DO NOT ADD PROTOCOL OR ANY OTHER PATH (no https, etc)

  • User: azeti IoT Platform username i.e. staging@aurubis.com

  • Password: azeti IoT Platform password for the username

The azeti Organization is automatically derived from the username after authentication, as each user can only be member of a single Organization.

Tip: Create a new Grafana data source for each Organization you’d like to query. This allows granular access control on a Organization basis within Grafana.

When pressing Save & Test, the Grafana instance should notify that everything is healthy

Frequently Asked Questions

I am missing a function/group by in the list, where is it?

Currently only the most common Aggregation functions and values for the group by are covered.

You can work around it by switching from the Visual Mode to Raw Query Mode and altering the query manually, i.e. by entering adjusting the group by time(..) clause.

Should we add more functions or different defaults values for group by? Let us know!

Feedback

We’re looking forward to hearing your feedback, please send us an e-mail at feedback@azeti.net and we’ll be in touch with you shortly.