> For the complete documentation index, see [llms.txt](https://docs.enlyze.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enlyze.com/integrations/grafana/enlyze-datenquelle.md).

# 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="/files/fItcundYDiyW1Cy8zh1z" 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 ENLYZE API abfragen](/integrations/grafana/advanced-api/02-api-queries.md).

<figure><img src="/files/PJvmQmO9Ik3PZdW98V1k" 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="/files/pnQhkVfCAf89aV2eZaJC" 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, einen ENLYZE API-Key einzugeben, der den Zugriff auf die ENLYZE Manufacturing Data Platform authentifiziert. Wir empfehlen hier einen Organisations API-Key, da dieser nicht an einen konkreten Nutzer geknüpft ist.

Wenn du das ENLYZE Plugin nutzen möchtest, kontaktiere deinen ENLYZE-Ansprechpartner. Wir stellen dir das Plugin bereit und unterstützen dich bei der Installation. Wie du den passenden API-Key anlegst, erfährst du unter [API-Keys verwalten](/administration/api-keys.md).

## 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="/files/OWUxfqm7hlJlQsH3Clbe" alt=""><figcaption></figcaption></figure>

### 2. Authentifizierung

* Gehe zu Authentication und wähle `Bearer Token`.
* Unter **Auth details > Bearer token** den ENLYZE API-Key eingeben. Falls du noch keinen hast, erfährst du unter [API-Keys verwalten](/administration/api-keys.md) wie du einen anlegst.
* 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="/files/fghotHNjA2CNruajMkBJ" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.enlyze.com/integrations/grafana/enlyze-datenquelle.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.