> For the complete documentation index, see [llms.txt](https://hub.equipme.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hub.equipme.io/pro/dokumentation/automation/insights.md).

# Insights (Protokolle)

Insights im Automation-Modul von Equipme Pro: Ausführungsprotokolle filtern, Ein- und Ausgaben je Schritt prüfen, Fehler verstehen und Benachrichtigungen bei Fehlern einrichten.

**Pfad:** „Automation“ → „Insights“

Unter **„Insights“** siehst du, was deine Flows getan haben: Jede Nachricht, die von einer Komponente zur nächsten fließt, wird protokolliert – mit Zeitpunkt, Daten und gegebenenfalls Fehler. So prüfst du, ob ein Flow wie erwartet läuft, und findest die Ursache, wenn etwas schiefgeht.

## Protokolle filtern

* **„Time range“:** Zeitraum wählen – über Schnellauswahlen („Shortcuts“) oder mit „From“ und „To“.
* **„Flows“:** Einen oder mehrere Flows auswählen; „Show selected“ zeigt nur die gewählten.
* **„Reload“** lädt neue Einträge, **„Load more“** ältere. Mit **„Start tracking“** werden neue Einträge laufend angezeigt, **„Pause tracking“** hält das an.

Die Protokolle **eines** Flows öffnest du auch direkt: in der [Flow-Liste](https://hub.equipme.io/pro/dokumentation/automation/workflows.md) über das Menü **„Insights“** oder im Flow-Designer über **„Logs“** in der Werkzeugleiste. Protokolle stehen für laufende und gestoppte Flows zur Verfügung.

## Einen Eintrag lesen

Ein Klick auf einen Eintrag öffnet die Details:

| Feld                              | Bedeutung                                                                 |
| --------------------------------- | ------------------------------------------------------------------------- |
| **„Status“**                      | „Success“ oder „Error“                                                    |
| **„Flow“**                        | Der betroffene Flow                                                       |
| **„Source Component“**            | Die Komponente, von der die Daten kamen                                   |
| **„Target Component“**            | Die Komponente, an die sie gingen                                         |
| **„Port Name“** / **„Port Type“** | Über welchen Anschluss die Daten flossen; „In“ = Eingabe, „Out“ = Ausgabe |
| **„Timestamp“**                   | Zeitpunkt                                                                 |
| **„Message“** / **„Data“**        | Die übergebenen Daten – also die Ein- oder Ausgabe des Schritts           |
| **„Error“** / **„Details“**       | Fehlermeldung und Einzelheiten                                            |

**Tipp:** Vergleiche die Daten am Ausgang eines Schritts mit dem, was der nächste Schritt erwartet. Die meisten Fehler entstehen, weil eine Variable leer ist oder einen anderen Wert enthält als gedacht.

## Typische Fehler und Lösungen

| Fehlerbild                                    | Ursache und Lösung                                                                                                                                                                                                  |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Flow tut gar nichts, keine Einträge           | Flow ist nicht gestartet, oder der Trigger findet keine passenden Daten. Flow starten, Trigger-Filter (z. B. „Customers“, „After“) prüfen. Manche Trigger fragen nur in Abständen ab – ein bis zwei Minuten warten. |
| Fehler mit „401“ oder „403“, nicht berechtigt | Anmeldung abgelaufen oder Rechte entzogen. Unter [Accounts](https://hub.equipme.io/pro/dokumentation/automation/accounts.md) den Account testen und neu verbinden.                                                  |
| Fehler „404“, nicht gefunden                  | Eine ID passt nicht, z. B. eine falsche Variable oder ein bereits gelöschter Eintrag. Daten des vorherigen Schritts prüfen.                                                                                         |
| Fehler „400“ oder „422“, ungültige Daten      | Ein Pflichtfeld fehlt oder hat das falsche Format, z. B. ein Datum statt einer E-Mail-Adresse. Feldzuordnung und Modifier prüfen.                                                                                   |
| Fehler „429“, Zeitüberschreitung oder „5xx“   | Das Fremdsystem ist überlastet oder kurz nicht erreichbar. Automation wiederholt solche Fehler selbst. Bei Schleifen eine Verzögerung („Delay“) einbauen.                                                           |
| Flow wurde gestoppt                           | Ein verwendeter Account wurde entfernt, oder die Fehlerbehandlung stoppt den Flow. Account ersetzen und Flow neu starten.                                                                                           |
| Doppelte Datensätze im Zielsystem             | Der Flow hat denselben Vorgang mehrfach verarbeitet. Bereits übertragene Nummern in einer [Tabelle](https://hub.equipme.io/pro/dokumentation/automation/files-and-tables.md) merken und vorher prüfen.              |

## Bei Fehlern benachrichtigt werden

Automation verschickt bei Fehlern **keine** E-Mails von sich aus. Für wichtige Flows baust du die Benachrichtigung selbst ein:

1. Öffne im Flow-Designer den kritischen Schritt, z. B. „Auftrag im ERP anlegen“.
2. Richte über „Error handling“ einen Fehler-Ausgang für diesen Schritt ein.
3. Verbinde den Fehler-Ausgang mit einer E-Mail-Aktion (Modul „Email“) oder einer Teams-Nachricht.
4. Setze Flow-Name, Fehlermeldung und die betroffene Auftragsnummer als Variablen in den Text.

So erfährt dein Team sofort, wenn z. B. ein Kundenauftrag nicht im ERP angekommen ist. Schau zusätzlich regelmäßig in „Insights“ mit dem Filter auf deine produktiven Flows.

## Häufige Fragen

**Warum sehe ich keine Einträge?**

Prüfe den Zeitraum („Time range“) und die gewählten Flows. Hat der Flow seit dem Start noch nichts verarbeitet, gibt es noch keine Einträge.

**Erscheinen auch Testläufe in den Protokollen?**

Ja. Testläufe werden wie normale Ausführungen protokolliert.

**Sehe ich die Protokolle der Flows meiner Kunden?**

Nein. Kunden sehen die Protokolle ihrer Flows in ihrem eigenen Portal.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://hub.equipme.io/pro/dokumentation/automation/insights.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
