> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/de/aktionen/workflow-concepts/workflow-logs.md).

# Protokolle

### Was sind Workflow-Protokolle?

Workflow-Protokolle bieten eine detaillierte, schrittweise Aufzeichnung von allem, was während einer Workflow-Ausführung geschieht. Sie erfassen den vollständigen Weg Ihrer Daten durch jeden Schritt Ihres Workflows, einschließlich:

* **Details zur Schrittausführung**: Laufzeit, Erfolgs-/Fehlerstatus und Anzahl der verarbeiteten Aufgaben
* **Eingabe- und Ausgabedaten**: Die genauen Daten, die in jeden Schritt eingeflossen sind, und das, was herausgekommen ist
* **Metadaten**: Informationen darüber, wer den Workflow ausgeführt hat, wann er ausgeführt wurde und aus welcher Quelle
* **Fehlermeldungen**: Detaillierte Fehlerinformationen, wenn Schritte fehlschlagen, die Ihnen helfen, Probleme zu identifizieren und zu beheben

### Warum Protokolle für Ihre Workflows wichtig sind

* **Workflow-Verhalten verstehen**: Sehen Sie genau, welche Daten in jeden Schritt hinein- und aus ihm herausfließen
* **Fehlgeschlagene Ausführungen debuggen**: Identifizieren Sie mithilfe detaillierter Fehlermeldungen, wo und warum Workflows fehlschlagen
* **Leistung optimieren**: Finden Sie Engpässe, indem Sie die Ausführungszeiten der Schritte überprüfen
* **Ohne erneute Ausführung iterieren**: Laden Sie jede frühere Ausführung mit allen erhaltenen Ausgaben in Studio

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-36890c9361066a3594d145f8e022af755fa2687f%2FCleanShot%202025-05-26%20at%2011.26.14%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

### Wo Sie Protokolle finden

* **Studio-Testmodus**: Klicken Sie auf das Verlaufssymbol oben rechts im Studio, um die Protokolle der Ausführungen dieses Workflows anzuzeigen
* **Workflow-Verlauf**: Greifen Sie über den Tab "Verlauf" in Ihrem Workflow auf alle früheren Ausführungen zu
* **Raster-Workflow-Spalten**: Klicken Sie auf eine beliebige Zelle in der Workflow-Spalte, um Protokolle für die Ausführung dieser bestimmten Zeile anzuzeigen

### Ausführungen in Studio laden

Die **"In Studio öffnen"** Schaltfläche ermöglicht es Ihnen, jede frühere Workflow-Ausführung zurück in Studio zu laden, wobei alle Schritt-Ausgaben wiederhergestellt werden. Diese leistungsstarke Funktion ermöglicht es Ihnen, Folgendes zu tun:

1. Probleme debuggen, ohne den gesamten Workflow erneut auszuführen
2. Änderungen mit echten Daten aus tatsächlichen Ausführungen testen
3. Wartezeiten für externe API-Aufrufe oder lang laufende Prozesse überspringen
4. Prompts und Logik mit Produktionsdaten iterieren

So verwenden Sie es: Klicken Sie einfach in der Protokollansicht einer beliebigen Ausführung auf „In Studio öffnen“. Das Studio wird mit allen ausgefüllten Zwischenausgaben geladen, sodass Sie jeden Schritt sofort ändern und testen können.

Dies ist besonders wertvoll beim Debuggen komplexer Workflows, beim Arbeiten mit zeitkritischen Daten oder bei der Zusammenarbeit an Verbesserungen des Workflows.

{% @arcade/embed url="<https://app.arcade.software/share/fc5g9N1qrk19HTAWNiKo>" flowId="fc5g9N1qrk19HTAWNiKo" %}

### Best Practices für die Verwendung von Protokollen

1. **Aussagekräftige Schrittnamen verwenden**: Geben Sie Ihren Schritten klare, aussagekräftige Namen, damit Protokolle leichter zu navigieren und zu verstehen sind
2. **Ausführungszeiten überwachen**: Behalten Sie die Schrittdauer im Auge, um Leistungseinbußen frühzeitig zu erkennen

Indem Sie die volle Leistungsfähigkeit der Protokolle nutzen, können Sie zuverlässigere Workflows erstellen, Probleme schneller debuggen und Ihre Automatisierungsprozesse kontinuierlich verbessern.


---

# 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://docs.airops.com/docs/de/aktionen/workflow-concepts/workflow-logs.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.
