> 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 passiert. Sie erfassen den gesamten Weg Ihrer Daten durch jeden Schritt Ihres Workflows, einschließlich:

* **Details zur Schrittausführung**: Laufzeitdauer, Erfolgs-/Fehlerstatus und Anzahl der verarbeiteten Aufgaben
* **Eingabe- und Ausgabedaten**: Die genauen Daten, die in jeden Schritt eingingen, und was dabei herauskam
* **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, damit Sie Probleme erkennen und beheben können

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

* **Workflow-Verhalten verstehen**: Sehen Sie genau, welche Daten in jeden Schritt hinein- und hinausfließen
* **Fehlerhafte Ausführungen debuggen**: Erkennen Sie anhand detaillierter Fehlermeldungen, wo und warum Workflows fehlschlagen
* **Leistung optimieren**: Finden Sie Engpässe, indem Sie die Ausführungszeiten der Schritte überprüfen
* **Iterieren, ohne erneut auszuführen**: Laden Sie jede frühere Ausführung mit allen intakten 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-d77f1992887169ca5b24426ff5f0969baf2de112%2Fworkflow-logs-01-execution.png?alt=media" alt="Logs tab of an execution listing the Prompt LLM, Score, and Run Code steps with durations and task counts, and the Run Code output expanded"><figcaption><p>Protokolle zeigen jeden Schritt einer Ausführung.</p></figcaption></figure>

### Wo Sie Protokolle finden

* **Studio-Testmodus**: Klicken Sie oben rechts im Studio auf das Verlaufssymbol, um die Protokolle der Ausführungen dieses Workflows anzuzeigen
* **Workflow-Verlauf**: Rufen Sie alle vergangenen Ausführungen über die Registerkarte "Verlauf" in Ihrem Workflow auf
* **Workflow-Spalten im Raster**: Klicken Sie auf eine beliebige Zelle in der Workflow-Spalte, um die Protokolle für die Ausführung dieser spezifischen Zeile anzuzeigen

### Ausführungen in Studio laden

Die **"In Studio öffnen"** Schaltfläche ermöglicht es Ihnen, jede frühere Workflow-Ausführung mit allen wiederhergestellten Schrittausgaben wieder in das Studio zu laden. Diese leistungsstarke Funktion ermöglicht Ihnen Folgendes:

1. Probleme debuggen, ohne den gesamten Workflow erneut auszuführen
2. Änderungen mit echten Daten aus tatsächlichen Ausführungen testen
3. Das Warten auf externe API-Aufrufe oder lang andauernde Prozesse überspringen
4. An 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 gefüllten Zwischenausgaben geladen, sodass Sie jeden Schritt sofort ändern und testen können.

Dies ist besonders wertvoll für das Debuggen komplexer Workflows, die Arbeit mit zeitkritischen Daten oder die Zusammenarbeit an Workflow-Verbesserungen.

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

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

1. **Verwenden Sie aussagekräftige Schritt-Namen**: Geben Sie Ihren Schritten klare, aussagekräftige Namen, damit sich die Protokolle leichter durchsuchen und verstehen lassen
2. **Ausführungszeiten überwachen**: Behalten Sie die Dauer der Schritte 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.
