# 03 Stillstandsauswertung

In diesem Tutorial erstellst du ein Dashboard zur Analyse von Maschinenstillständen mit Kreisdiagramm, Zeitstrahl und Detailtabelle:

<figure><img src="https://3556205377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6Jn6Re8NNPSKD1jGZyL%2Fuploads%2Fgit-blob-526ae91df106c74629f265bba54ea1fc8b64e850%2Fgrafana-downtime-hero-01.png?alt=media" alt=""><figcaption></figcaption></figure>

## Was du lernst

* Den downtimes-API-Endpoint abfragen
* Stillstandsdauer mit Transformationen berechnen
* Stillstände mit Kreisdiagramm, Bar Gauge und State Timeline visualisieren
* Value Mappings für Stillstandskategorien einrichten

## Voraussetzungen

* [ENLYZE API abfragen](https://docs.enlyze.com/integrations/grafana/advanced-api/02-api-queries) und [Variablen](https://docs.enlyze.com/integrations/grafana/advanced-api/03-variables) abgeschlossen
* Verständnis von Infinity-Queries und Transformationen

***

## Stillstände abfragen

| Einstellung   | Wert                                                                         |
| ------------- | ---------------------------------------------------------------------------- |
| Type          | JSON                                                                         |
| Parser        | Backend                                                                      |
| Method        | GET                                                                          |
| URL           | `downtimes?machine=${machine}&start=${__from:date:iso}&end=${__to:date:iso}` |
| Root selector | siehe JSONata                                                                |

Die API liefert Stillstände mit verschachtelter Grund-Information. Verwende JSONata, um die Felder zu extrahieren und fehlende Endzeiten aufzufüllen:

```
$.data.{
  "start": start,
  "end": end ? end : $now(),
  "category": reason.category ? reason.category : "UNKNOWN",
  "reason": reason.name
}
```

{% hint style="info" %}
Wenn `end` den Wert `null` hat, ist der Stillstand noch aktiv. `$now()` ersetzt fehlende Endzeiten durch den aktuellen Zeitpunkt.
{% endhint %}

<figure><img src="https://3556205377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6Jn6Re8NNPSKD1jGZyL%2Fuploads%2Fgit-blob-cc43bf7b451fc14d65fc1c4b9398ab27459b2fbb%2Fgrafana-downtime-query-01.png?alt=media" alt=""><figcaption></figcaption></figure>

***

## Stillstandsdauer berechnen

Die Dauer lässt sich mit Transformationen aus Start- und Endzeit berechnen:

1. **Convert field type**: start und end → Time
2. **Add field from calculation**: Mode Binary, end - start → `duration_ms`
3. **Add field from calculation**: duration\_ms / 1000 → `duration`

Setze die Unit des `duration`-Felds auf **Duration (d hh:mm:ss)** (`dtdhms`).

<figure><img src="https://3556205377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6Jn6Re8NNPSKD1jGZyL%2Fuploads%2Fgit-blob-9e1b861a2201de141d2acfa3f24248e0b71cf98a%2Fgrafana-downtime-duration-transform-01.png?alt=media" alt=""><figcaption></figcaption></figure>

***

## Kreisdiagramm nach Kategorie

Visualisiere die Verteilung der Stillstandskategorien:

1. Verwende die Basis-Query mit den Transformationen zur Dauerberechnung
2. Füge eine **Group by**-Transformation hinzu: Group by `category`, Aggregate `duration` → Sum
3. Wähle die Visualisierung **Pie Chart**

Richte **Value Mappings** ein, um die API-Werte lesbar zu machen:

| API-Wert       | Anzeige              | Farbe  |
| -------------- | -------------------- | ------ |
| PLANNED        | Geplanter Stillstand | Blau   |
| UNPLANNED      | Ungeplant (manuell)  | Orange |
| NOT\_SCHEDULED | Nicht eingeplant     | Grau   |
| UNKNOWN        | Kein Grund           | Gelb   |

<figure><img src="https://3556205377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6Jn6Re8NNPSKD1jGZyL%2Fuploads%2Fgit-blob-87e0bb6b1a75c3ea650342d36787a67a570da746%2Fgrafana-downtime-pie-01.png?alt=media" alt=""><figcaption></figcaption></figure>

***

## Bar Gauge nach Kategorie

Zeige die Dauer pro Kategorie als horizontale Balken:

| Einstellung   | Wert                  |
| ------------- | --------------------- |
| Visualization | Bar Gauge             |
| Orientation   | Horizontal            |
| Display mode  | Basic                 |
| Unit          | Duration (d hh:mm:ss) |

Verwende die gleiche Query und Transformationen wie beim Kreisdiagramm.

<figure><img src="https://3556205377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6Jn6Re8NNPSKD1jGZyL%2Fuploads%2Fgit-blob-d42c596d446046f4fb2bb0d7327aa5bfcf640cdb%2Fgrafana-downtime-bargauge-01.png?alt=media" alt=""><figcaption></figcaption></figure>

***

## State Timeline

Zeige, wann Stillstände im Zeitverlauf aufgetreten sind:

| Einstellung   | Wert           |
| ------------- | -------------- |
| Visualization | State timeline |
| Merge values  | On             |

Verwende dieselben Value Mappings wie beim Kreisdiagramm, damit die Kategorien farblich konsistent sind.

<figure><img src="https://3556205377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6Jn6Re8NNPSKD1jGZyL%2Fuploads%2Fgit-blob-8dfc0e6a538e55c97afb9931594aaa31e36a4eae%2Fgrafana-downtime-timeline-01.png?alt=media" alt=""><figcaption></figcaption></figure>

***

## Detailtabelle

Zeige einzelne Stillstandsereignisse mit allen Details:

| Spalte   | Typ       | Besonderheit   |
| -------- | --------- | -------------- |
| start    | Timestamp | dateTimeAsIso  |
| end      | Timestamp | dateTimeAsIso  |
| duration | Number    | Unit: dtdhms   |
| category | String    | Value Mappings |
| reason   | String    | -              |

<figure><img src="https://3556205377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6Jn6Re8NNPSKD1jGZyL%2Fuploads%2Fgit-blob-e0e4bbe896f66ab8d430a6c09ab2a3be6d654ce2%2Fgrafana-downtime-table-01.png?alt=media" alt=""><figcaption></figcaption></figure>

***

## Tipps

* **Stillstandskategorien**: `PLANNED` (geplante Wartung, Rüsten), `UNPLANNED` (manuell gemeldet), `NOT_SCHEDULED` (keine Produktion eingeplant). Verwende konsistente Farben in allen Panels.
* **Laufende Stillstände**: Ersetze `null`-Endzeiten mit `$now()` in JSONata, damit die Dauerberechnung funktioniert.
* **Leere Daten**: Prüfe den Zeitbereich. Stillstände sind nur für Zeiträume verfügbar, in denen die Maschine aktiv war.
* **Pareto-Analyse**: Filtere auf `UNPLANNED`, gruppiere nach `reason` und sortiere absteigend nach `duration`, um die häufigsten Stillstandsgründe zu identifizieren.

***

## Nächste Schritte

* [**Shopfloor-Monitoring**](https://docs.enlyze.com/integrations/grafana/production-dashboards/01-shopfloor-monitoring) - Dashboards für große Bildschirme und Mobilgeräte erstellen