log komponente

Log Komponente

https://www.loom.com/share/4a0c0c8760d74d2cb9752b066a5b387f

1. Zweck

Die Log-Nachricht ist das zentrale Werkzeug für das Monitoring und Debugging von Flows. Sie ermöglicht, beliebige Informationen oder Variablenwerte während der Flow-Ausführung in den Logs auszugeben. Indem Sie an Schlüsselstellen benutzerdefinierte Protokolleinträge erstellen, erhalten Sie Einblick in die verarbeiteten Daten und die getroffenen Entscheidungen.

2. Anwendung

1

Flow öffnen und Komponente hinzufügen

• Öffne deinen Flow im Flow Editor.

• Füge über das „+“-Symbol im Editor die Komponente „Log-Nachricht“ hinzu.

Bildschirmfoto 2025-10-29 um 16.12.36.png

2

Einstellungen öffnen

• Öffne die Einstellungen dieser Komponente.

3

Felder definieren

Definiere:

• Titel der Log-Nachricht (wird in der Log-Übersicht angezeigt)

• Log-Level:

  • Nachricht → einfache Information

  • Warnung → Hinweis auf mögliche Probleme

  • Fehler → kritische Meldung, bricht Flow ab

• Payload: Welche Daten sollen im Log erscheinen?

4

Beispielansicht

Bildschirmfoto 2025-10-29 um 16.13.33.png

3. Aufbau des Payloads

Der Payload kann auf zwei Arten definiert werden:

Variante	Beschreibung	Beispiel
Einzeln definierte Variablen	Mehrere Werte mit Name und Ausdruck einzeln hinzufügen	Name: CustomerID, Wert: {{order.customer_id}}
Gesamte Variable / JSON-Objekt	Komplette Datenstruktur als Log-Inhalt	Variable: {{output.sales_order}}

Tipp: Nutze geschweifte Klammern {} im Feld „Daten“, um eine komplexe Struktur (z. B. JSON-Payload) einzubinden.

Beispiel:

Beispiel Payload

{
  "order_id": "{{output.sales_order.id}}",
  "total": "{{output.sales_order.total}}"
}

4. Typische Einsatzszenarien

• Überwachung von Zwischenergebnissen während der Flow-Ausführung

• Debugging von Variablenwerten und API-Antworten

• Dokumentation relevanter Prozessschritte für spätere Analysen

• Ausgabe von Warnungen oder Fehlern, wenn bestimmte Bedingungen erfüllt sind, der Flow aber fortgesetzt werden muss

• Aufzeichnen einer „Erfolgs“-Nachricht am Ende eines komplexen Prozesses

Beispiel: Im Schritt „API-Antwort prüfen“ kann eine Log-Nachricht eingefügt werden, die den Rückgabestatus und die ID der erzeugten Bestellung dokumentiert.

5. Log-Ausgabe prüfen

1

Flow-Übersicht öffnen

Öffne die Flow-Übersicht.

2

Reporting öffnen

Klicke beim gewünschten Flow auf das Lupen-Symbol 🔍.

3

Log-Detailansicht

In der Detailansicht erscheinen alle Log-Einträge mit:

• Titel

• Zeitstempel

• Log-Level

• Optionalem Payload (über „i“ einsehbar)

Damit erhältst du eine lückenlose Übersicht über den Ablauf und die Datenverarbeitung des Workflows.

Hinweis: Das Reporting kann auch direkt aus dem Flow-Editor in der Sidebar über das Lupen-Symbol 🔍 geöffnet werden.

Bildschirmfoto 2025-10-29 um 16.15.04.png

6. Best Practices

• Nutze Log-Nachrichten regelmäßig – insbesondere in Test- und Entwicklungsphasen.

• Logge gezielt, um die Übersichtlichkeit zu bewahren – insbesondere in produktiven Flows. Vermeide redundante Logs und logge nur so viel wie nötig.

• Definiere aussagekräftige Titel (Log Nachricht), die idealerweise dynamische IDs enthalten (z. B. Kunde {{customer.id}} wird verarbeitet).

• Verwende Log-Prioritäten gezielt:

  • Logging (Nachricht) für Standard-Informationen

  • Warning (Warnung) für ungewöhnliche, aber nicht kritische Situationen

  • Error (Fehler) für problematische Zustände, die nicht zum Abbruch führen, aber hervorgehoben werden sollen

• Keine Ausgabe: Das Logging-Element erzeugt selbst keine Ausgabevariablen für die weitere Nutzung im Flow. Es dient ausschließlich zum Schreiben von Protokollen.