Skip to main content

​
Debugging

Erfahren Sie, wie Sie Probleme in Ihren Automate-Workflows effektiv debuggen und beheben.

​
Debugging-Grundlagen

Systematisch vorgehen

Gehen Sie methodisch vor, um Probleme zu identifizieren.

Logs nutzen

Execution Logs sind Ihre beste Quelle für Debugging-Informationen.

Isolation

Isolieren Sie das Problem, indem Sie einzelne Nodes testen.

Dokumentation

Dokumentieren Sie gefundene Probleme und Lösungen.

​
Execution Logs

​
Logs analysieren

So öffnen Sie Execution Logs:
  1. Navigieren Sie zum “Executions” Tab
  2. Wählen Sie eine Execution aus
  3. Klicken Sie auf die Execution, um Details zu sehen
  4. Öffnen Sie jeden Node, um Input/Output zu sehen
Filtern Sie nach fehlgeschlagenen Executions für schnelleres Debugging.
Was Sie in Logs sehen:
  • Input: Daten, die der Node empfangen hat
  • Output: Daten, die der Node produziert hat
  • Execution Time: Wie lange der Node gebraucht hat
  • Status: Erfolg oder Fehler
  • Error Messages: Detaillierte Fehlermeldungen
Häufige Fehler-Indikatoren:
  • Rote Nodes (fehlgeschlagen)
  • Gelbe Nodes (Warnungen)
  • Fehlende Verbindungen
  • Timeout-Meldungen
  • API-Fehler (4xx, 5xx)

​
Häufige Probleme und Lösungen

​
Problem 1: Workflow läuft nicht

Symptom: Workflow wird nicht ausgeführtLösung:
  1. Überprüfen Sie den “Active” Toggle oben rechts
  2. Stellen Sie sicher, dass er auf “Active” steht
  3. Prüfen Sie, ob der Trigger korrekt konfiguriert ist
Symptom: Workflow startet nicht automatischLösung:
  1. Überprüfen Sie Trigger-Konfiguration
  2. Testen Sie Trigger manuell
  3. Prüfen Sie Credentials für Trigger (z.B. IMAP)
  4. Validiere Webhook-URL und Secret
Symptom: Authentifizierung schlägt fehlLösung:
  1. Überprüfen Sie Credentials in Node-Einstellungen
  2. Testen Sie Credentials einzeln
  3. Stellen Sie sicher, dass Credentials nicht abgelaufen sind
  4. Überprüfen Sie Environment Variables

​
Problem 2: Daten werden nicht korrekt übergeben

Symptom: Node erhält keine oder falsche DatenLösung:
  1. Überprüfen Sie Expression-Syntax: {{ $json.fieldName }}
  2. Prüfen Sie Feldnamen (Case-Sensitive!)
  3. Verwenden Sie Expression-Editor für Validierung
  4. Testen Sie Expressions mit “Execute Node”
// Zugriff auf vorherige Node-Daten
{{ $json.email }}
{{ $json.user.name }}

// Zugriff auf spezifischen Node
{{ $('Node Name').item.json.field }}

// Funktionen
{{ $json.text.toUpperCase() }}
{{ $now.toISO() }}
Symptom: Node erwartet anderes FormatLösung:
  1. Überprüfen Sie Datenformate zwischen Nodes
  2. Verwenden Sie “Set” Nodes zur Transformation
  3. Validieren Sie mit JSON Schema
  4. Prüfen Sie Execution Logs für tatsächliche Datenformate
Symptom: Node greift auf Daten zu, die noch nicht existierenLösung:
  1. Überprüfen Sie Workflow-Struktur
  2. Stellen Sie sicher, dass Daten-Nodes vor Verwendungs-Nodes kommen
  3. Verwenden Sie “Set” Nodes zur Datenvorbereitung

​
Problem 3: Agent gibt keine Antwort

Symptom: Agent wird nicht gefundenLösung:
  1. Überprüfen Sie Agent-ID im Node
  2. Stellen Sie sicher, dass Agent existiert und verfügbar ist
  3. Prüfen Sie Agent-Berechtigungen
  4. Testen Sie Agent direkt im Agent-Interface
Symptom: Agent gibt Fehler zurückLösung:
  1. Überprüfen Sie Prompt-Syntax
  2. Testen Sie Prompt direkt im Agent-Interface
  3. Validiere Prompt-Länge und Format
  4. Prüfen Sie, ob alle Variablen korrekt eingesetzt werden
Symptom: Agent-Aufrufe schlagen fehlLösung:
  1. Überprüfen Sie API-Quotas
  2. Prüfen Sie Rate Limits
  3. Implementieren Sie Retry-Logik mit Backoff
  4. Kontaktieren Sie Support bei anhaltenden Problemen

​
Debugging-Techniken

​
1. Node-Level Debugging

Testen Sie jeden Node einzeln:
1

Node isolieren

  1. Öffnen Sie den Node
  2. Verwenden Sie Test-Daten
  3. Klicken Sie auf “Execute Node”
2

Input prüfen

  1. Überprüfen Sie Input-Daten
  2. Validiere Datenformat
  3. Prüfen Sie auf fehlende Felder
3

Output prüfen

  1. Überprüfen Sie Output-Daten
  2. Validiere erwartetes Format
  3. Prüfen Sie auf unerwartete Werte

​
2. Workflow-Level Debugging

Debuggen Sie den gesamten Workflow: 
{
  "step1": "Aktiviere 'Save Data on Error'",
  "step2": "Führe Workflow mit Test-Daten aus",
  "step3": "Prüfe Execution Logs",
  "step4": "Identifiziere fehlgeschlagene Nodes",
  "step5": "Debugge jeden fehlgeschlagenen Node",
  "step6": "Teste Fixes einzeln",
  "step7": "Führe vollständigen Workflow-Test durch"
}

​
3. Logging hinzufügen

Fügen Sie Debug-Logs hinzu: 
// Log wichtige Werte
console.log('User ID:', {{ $json.userId }});
console.log('Email:', {{ $json.email }});
console.log('Processing step:', 'email-sent');

// Log in Set Node
{
  "debug": {
    "step": "before-agent-call",
    "data": "={{ $json }}",
    "timestamp": "={{ $now.toISO() }}"
  }
}

​
Debugging-Tools

​
Automate Debugging-Features

Execute Node

Testen Sie einzelne Nodes mit Test-Daten.

Execution Logs

Detaillierte Logs für jede Execution.

Save Data on Error

Speichert Daten auch bei Fehlern für Debugging.

Expression Editor

Validiert Expressions vor Ausführung.

​
Best Practices

Systematisch vorgehen

Gehen Sie Schritt für Schritt vor, nicht zufällig.

Logs nutzen

Execution Logs sind Ihre beste Informationsquelle.

Isolation

Isolieren Sie Probleme durch Node-Level-Testing.

Dokumentation

Dokumentieren Sie Probleme und Lösungen.

​
Debugging-Checkliste

  • Execution Logs wurden überprüft
  • Fehlgeschlagene Nodes wurden identifiziert
  • Jeder fehlgeschlagene Node wurde einzeln getestet
  • Input/Output-Daten wurden validiert
  • Expressions wurden auf Syntax-Fehler geprüft
  • Datenformate wurden überprüft
  • Credentials wurden validiert
  • Error Messages wurden gelesen und verstanden

​
Häufige Fehlermeldungen

Fehler: “Request timeout after 30s”Lösung:
  • Erhöhen Sie Timeout-Wert
  • Optimieren Sie API-Call
  • Implementieren Sie Retry-Logik
Fehler: “401 Unauthorized”Lösung:
  • Überprüfen Sie Credentials
  • Prüfen Sie Token-Ablauf
  • Validiere API-Key Format
Fehler: “Invalid data format”Lösung:
  • Überprüfen Sie Datenformat
  • Verwenden Sie Set Node zur Transformation
  • Validiere mit JSON Schema
Weiterführende Themen: Lesen Sie auch unsere Seiten zu Testing und Performance für weitere Debugging-Techniken.