ENLYZE data source

Overview of available data sources and how to connect ENLYZE to Grafana

With Grafana you can visualize data from the ENLYZE Manufacturing Data Platform. You can either use a self-hosted Grafana instance or the ENLYZE-hosted Platform Grafana. To retrieve data, two types of data sources are available.

ENLYZE Grafana Plugin

This is a Grafana plugin developed by ENLYZE. You can use it to retrieve machine data such as line speeds, temperature, and pressure values. This data source is ideal for time series displays, status displays, and comparisons of target and actual values.

The control panel consists of drop-down input fields for site, machine, and variable. All active variables of the ENLYZE app can be called up.

The ENLYZE plugin is available by default in Platform Grafana. If you are running your own Grafana instance, see the installation instructions below.

Infinity Data Source (ENLYZE API)

The Infinity data source is a plugin developed by Grafana that serves as a connector for APIs. This makes it ideal for establishing a connection to the ENLYZE API. You can find out more about Infinity data sources in the official Grafana documentation.

A data source connected to the ENLYZE API provides direct access to several predefined data tables. Detailed descriptions of the data contained can be found in the linked API documentation.

• Sites: All sites present in the ENLYZE Data Platform.

• Machines: All machines for all sites.

• Products: All products registered on the platform.

• Variables: All active variables from all machines.

• Production Runs: All production runs registered on the platform.

• Downtimes: All downtimes registered on the platform.

The ENLYZE API section of this documentation provides tutorials on how to use the Infinity data source with the ENLYZE API.

Connecting a self-managed Grafana instance

If you are running your own Grafana instance and would like to start using ENLYZE data, you can install the ENLYZE plugin or configure an Infinity data source to connect to the ENLYZE API.

Installation of the ENLYZE plugin

The ENLYZE Grafana plugin needs to be installed manually and is not listed in the Grafana plugin catalogue.

We can create a signed version of the ENLYZE plugin specifically for your instance. To do this, we will need the root_url of your Grafana instance. Once you receive the signed ENLYZE plugin, you will need to install it manually. In the Grafana documentation, you can find a detailed description about how to install plugins in Grafana manually.

After the installation, you will have to add the new data source, which can be found under the name Enlyze.

If the data source doesn't appear as an option, try restarting Grafana.

While setting up the data source, you will be prompted to add the ENLYZE API Key, which authenticates your access to the ENLYZE Manufacturing Data Platform.

If you are interested in using the ENLYZE plugin, contact your ENLYZE representative, and we will provide you with the plugin and the API Key.

Configuring the Infinity Data Source

The Infinity data source can be configured to connect to the ENLYZE API. Here are the necessary settings:

1. Adding the data source

Start by adding a new Infinity data source in your Grafana instance.

2. Authentication

• Go to Authentication and choose Bearer Token.

• Under Auth details > Bearer token, enter the ENLYZE API Key. If you don't have one yet, contact your ENLYZE representative.

• Under Allowed Hosts enter https://app.enlyze.com.

3. Base URL

• Go to URL, Headers & Params.

• Under Base URL enter: https://app.enlyze.com/api/v2/.

4. Security

• Go to Security.

• Under Allowed hosts enter: https://app.enlyze.com.

5. Health check

• Go to Health check.

• Check that the custom health check is enabled.

• Under Health check URL enter: https://app.enlyze.com/api/v2/openapi.json.

Finally, click on Save & test. If the configuration worked correctly, you should see a successful health check confirming the connection to the API.