# ENLYZE-Datenquellen für Grafana

Mit Grafana lassen sich Daten aus der ENLYZE Manufacturing Data Platform einfach visualisieren. Du kannst entweder eine selbst gehostete Grafana-Instanz oder Platform Grafana nutzen. Für den Datenabruf stehen zwei Datenquellen zur Verfügung. Hier erfährst du mehr über diese Verbindungen und welche Daten du damit abrufen kannst.

## ENLYZE Grafana Plugin

Das ENLYZE Grafana Plugin wurde von ENLYZE entwickelt. Damit lassen sich Maschinendaten wie Liniengeschwindigkeiten, Temperatur- und Druckwerte abrufen. Diese Datenquelle eignet sich daher ideal für Zeitreihenanzeigen, Statusanzeigen und Vergleiche von Soll- und Istwerten.

Das Bedienfeld besteht aus Dropdown-Feldern für Standort, Maschine und Variable. Alle aktiven Variablen der ENLYZE-App können abgerufen werden.

<figure><img src="https://3556205377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6Jn6Re8NNPSKD1jGZyL%2Fuploads%2FG36g63bOXuLY4iIyYg96%2Fgrafik.png?alt=media&#x26;token=62c29c4d-a69e-419a-889b-9595d9781815" alt=""><figcaption></figcaption></figure>

Das ENLYZE Plugin ist in Platform Grafana standardmäßig verfügbar. Wenn du eine eigene Grafana-Instanz betreibst, findest du unter [Installation des ENLYZE Plugins](#installation-des-enlyze-plugins) eine Anleitung zur Installation.

## Infinity-Datenquelle

Die Infinity-Datenquelle ist ein von Grafana entwickeltes Plugin, das als Connector für APIs dient. Damit eignet sie sich ideal für die Anbindung an die [ENLYZE API](https://app.enlyze.com/api/v2/redoc). Weitere Informationen zur Infinity-Datenquelle findest du in der offiziellen [Grafana-Dokumentation](https://grafana.com/docs/plugins/yesoreyeram-infinity-datasource/latest/).

Eine mit der ENLYZE API verbundene Datenquelle bietet direkten Zugriff auf mehrere vordefinierte Datentabellen. Detaillierte Beschreibungen der enthaltenen Daten findest du in der verlinkten API-Dokumentation.

* [**Sites**](https://app.enlyze.com/api/v2/redoc#operation/get_sites_v2_sites_get): Alle in der ENLYZE-Plattform vorhandenen Standorte.
* [**Machines**](https://app.enlyze.com/api/v2/redoc#operation/get_machines_v2_machines_get): Alle Maschinen aller Standorte.
* [**Products**](https://app.enlyze.com/api/v2/redoc#operation/get_products_v2_products_get): Alle bisher auf der Plattform erfassten Produkte.
* [**Variables**](https://app.enlyze.com/api/v2/redoc#operation/get_variables_v2_variables_get): Alle aktiven Variablen aller Maschinen.
* [**Production Runs**](https://app.enlyze.com/api/v2/redoc#operation/get_production_runs_v2_production_runs_get): Alle auf der Plattform erfassten Aufträge aller Maschinen.
* [**Downtimes**](https://app.enlyze.com/api/v2/redoc#operation/get_downtimes_v2_downtimes_get): Alle auf der Plattform erfassten Stillstände aller Maschinen.

Die Nutzung dieser Datenquelle ist vielseitig. Einen ersten Einblick in die Verwendung der Infinity-Datenquelle bietet das Tutorial [02-api-queries](https://docs.enlyze.com/integrations/grafana/advanced-api/02-api-queries "mention").

<figure><img src="https://3556205377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6Jn6Re8NNPSKD1jGZyL%2Fuploads%2FwtLsibM0t2lhDiFZfmZP%2Fimage.png?alt=media&#x26;token=23ad5e46-1e9d-4737-97d3-2b3196c98531" alt=""><figcaption></figcaption></figure>

## Installation des ENLYZE Plugins

Wenn du eine eigene Grafana-Instanz betreibst und das ENLYZE Plugin nutzen möchtest, kannst du es manuell installieren. Das Plugin ist nicht im Grafana Plugin-Katalog gelistet.

Wir können eine signierte Version des ENLYZE Plugins speziell für deine Instanz erstellen. Dafür benötigen wir die [`root_url`](https://grafana.com/docs/grafana/latest/setup-grafana/configure-grafana/#root_url) deiner Grafana-Instanz. Nach Erhalt des signierten Plugins muss es manuell installiert werden. In der [Grafana-Dokumentation](https://grafana.com/docs/grafana/latest/administration/plugin-management/#install-plugin-on-local-grafana) findest du eine detaillierte Anleitung zur manuellen Plugin-Installation.

Nach der Installation musst du die neue Datenquelle hinzufügen, die unter dem Namen **Enlyze** zu finden ist.

<figure><img src="https://3556205377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6Jn6Re8NNPSKD1jGZyL%2Fuploads%2FPiluEG55fudNOkrnzfPr%2Fimage.png?alt=media&#x26;token=af2f7e16-01b1-4249-a0b9-00a9c958bad7" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Falls die Datenquelle nicht als Option angezeigt wird, starte Grafana neu.
{% endhint %}

Bei der Einrichtung der Datenquelle wirst du aufgefordert, den ENLYZE API-Token einzugeben, der deinen Zugriff auf die ENLYZE Manufacturing Data Platform authentifiziert.

Wenn du das ENLYZE Plugin nutzen möchtest, kontaktiere deinen ENLYZE-Ansprechpartner. Wir stellen dir das Plugin und den API-Token bereit und unterstützen dich bei der Installation.

## Konfiguration der Infinity-Datenquelle für die ENLYZE API

Die [Infinity-Datenquelle](https://grafana.com/docs/plugins/yesoreyeram-infinity-datasource/latest/) lässt sich für die Verbindung mit der ENLYZE API konfigurieren. Hier findest du die notwendigen Einstellungen für die korrekte Konfiguration.

### 1. Datenquelle hinzufügen

Füge zunächst eine neue Infinity-Datenquelle hinzu.

<figure><img src="https://3556205377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6Jn6Re8NNPSKD1jGZyL%2Fuploads%2Fxrlu9JJ1OkeCibGeGZtF%2Fimage.png?alt=media&#x26;token=838dc403-3a0f-4580-991c-f2954d26602e" alt=""><figcaption></figcaption></figure>

### 2. Authentifizierung

* Gehe zu Authentication und wähle `Bearer Token`.
* Unter **Auth details > Bearer token** den ENLYZE API-Token eingeben. Falls du noch keinen hast, kontaktiere deinen ENLYZE-Ansprechpartner.
* Unter **Allowed Hosts** `https://app.enlyze.com` eingeben.

### 3. Base URL

* Gehe zu URL, Headers & Params.
* Unter **Base URL** eingeben: `https://app.enlyze.com/api/v2/`.

### 4. Sicherheit

* Gehe zu Security.
* Unter **Allowed hosts** eingeben: `https://app.enlyze.com`.

### 5. Health Check

* Gehe zu Health check.
* Prüfe, dass der Custom Health Check aktiviert ist.
* Unter **Health check URL** eingeben: `https://app.enlyze.com/api/v2/openapi.json`.

Klicke abschließend auf **Save & test**. Wenn die Konfiguration korrekt ist, wird ein erfolgreicher Health Check angezeigt, der die Verbindung zur API bestätigt:

<figure><img src="https://3556205377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6Jn6Re8NNPSKD1jGZyL%2Fuploads%2Fw6pd9YBv9KqdVVYQ0vck%2Fimage.png?alt=media&#x26;token=7ec5b28f-eb55-4d7c-b371-349b928815cc" alt=""><figcaption></figcaption></figure>