Debugging von Node-RED

Diese Anleitung bietet umfassende Verfahren zur Fehlerbehebung von Node-RED-Problemen auf dem OV10i-Kamerasystem. Verwenden Sie sie für Reparaturen vor Ort, das Debuggen von Produktionsproblemen und die vorbeugende Wartung von Inspektionsabläufen.

warnung

Sicherheit zuerst: Informieren Sie immer die Produktion, bevor Sie Änderungen an aktiven Inspektionssystemen vornehmen. Erstellen Sie Backups, bevor Sie Flows modifizieren.

Notfall-Schnellbehebungsverfahren

Kritischer Systemausfall – Sofortmaßnahmen

Schritt	Aktion	Zeit	Ergebnis
1	Status der Kamera-Power-LED prüfen	30 Sek.	Hardware-Funktion bestätigen
2	OV10i Node-RED aufrufen: http://camera-ip/recipes/<recipe-number>/ioblock	1 Min.	Editor-Zugriff bestätigen
3	Nach roten Dreieck-Fehleranzeigen suchen	1 Min.	Fehlerhafte Nodes identifizieren
4	Schaltfläche Deploy klicken (Full Deploy)	30 Sek.	Alle Flows zurücksetzen
5	Grundlegenden Inspektionstrigger testen	2 Min.	Systembetrieb verifizieren

Systemwiederherstellung (Wenn der Editor nicht lädt)

OV10i-Kameras verfügen über keinen Safe Mode – ein Neustart ist die primäre Wiederherstellungsmethode:

1. Kamera vom Strom trennen (Stromversorgung für 10 Sekunden abziehen)
2. Vollständigen Bootvorgang abwarten (alle 4 LEDs stabil – 2–3 Minuten)
3. Node-RED des aktiven Rezepts über die rezeptspezifische URL aufrufen
4. Flow-Integrität verifizieren und notwendige Korrekturen vornehmen
5. Änderungen deployen, um den Normalbetrieb wiederherzustellen

hinweis

URL-Format: http://<camera-ip>/recipes/<recipe-number>/ioblock

Beispiele:

• http://192.168.0.101/recipes/20/ioblock
• http://192.168.0.105/recipes/1/ioblock

Systematischer Debugging-Prozess

Schritt 1: Problemumfang identifizieren

Fragen zur Schnellbewertung

Frage	Bei JA	Bei NEIN
Können Sie auf die OV10i Node-RED-Oberfläche zugreifen?	Weiter zu Schritt 2	Netzwerk-/Kamera-Status prüfen
Sind Flows im Editor sichtbar?	Weiter zu Schritt 2	Kamera neu starten und erneut versuchen
Sehen Sie Fehlerdreiecke an Nodes?	Diese Nodes zuerst fokussieren	Flow-Ausführung prüfen
Wird die Inspektion getriggert?	Ausgänge einzelner Nodes prüfen	Trigger-Eingänge verifizieren

hinweis

Zugriffs-URL: Verwenden Sie das rezeptspezifische URL-Format: http://<camera-ip>/recipes/<recipe-number>/ioblock

Schritt 2: Debug-Überwachung aktivieren

Debug-Nodes zur Fehlerbehebung hinzufügen

1. Platzieren Sie Debug-Nodes an wichtigen Punkten in problematischen Flows:
   • Nach Trigger-Eingängen
   • Vor und nach Logik-Nodes
   • An finalen Ausgängen
2. Konfigurieren Sie Debug-Nodes für maximale Informationen:
   • Output: Komplettes Nachrichtenobjekt
   • To: Debug-Seitenleiste
   • Name: Beschreibende Namen (z. B. „After Classification Logic")
3. Aktivieren Sie alle Debug-Nodes, indem Sie deren Schaltflächen im Editor anklicken

Verwaltung der Debug-Seitenleiste

Debug-Seitenleiste aufrufen:

• Klicken Sie auf den Debug-Tab (Käfer-Symbol) im rechten Panel
• Alte Nachrichten löschen über das Papierkorb-Symbol
• Nachrichten filtern, wenn zu viele Nodes aktiv sind

Interpretation von Debug-Nachrichten:

• Timestamp zeigt, wann die Nachricht aufgetreten ist
• Node-Name zeigt, welcher Node die Nachricht generiert hat
• Nachrichteninhalt zeigt Datenstruktur und Werte

Schritt 3: Flow-Ausführung nachverfolgen

Nachrichtenpfad verfolgen

1. Bei der Auslösequelle beginnen (Injection, Timer, externer Eingang)
2. Überprüfen, ob jeder Node den erwarteten Input erhält
3. Nachrichtentransformationen bei jedem Schritt prüfen
4. Identifizieren, wo der Flow stoppt oder eine falsche Ausgabe erzeugt

Häufige Unterbrechungspunkte im Flow

Node-Typ	Häufige Probleme	Schnellprüfung
Classification Logic	Konfidenzschwelle nicht erreicht	ROI-Ausrichtung prüfen, Modell neu trainieren
Switch Node	Falsche Bedingungslogik	Switch-Regeln und Nachrichteneigenschaften überprüfen
Join Node	Wartet auf unvollständigen Nachrichtensatz	Anzahl der Nachrichtenteile prüfen
Function Node	JavaScript-Fehler	Browser-Konsole auf Fehler prüfen
HTTP Request	Netzwerkkonnektivität	Endpoint manuell testen

Häufige Node-RED-Probleme & Lösungen

Probleme bei der Flow-Ausführung

Problem: Flow wird nicht ausgelöst

Symptome:

• Keine Nachrichten in der Debug-Seitenleiste
• System wirkt inaktiv
• Externe Trigger funktionieren nicht

Diagnoseschritte:

1. Auslösequelle prüfen: Manuelle Injection, Timer, externer Eingang
2. Verkabelung überprüfen: Verbindungen zwischen Nodes sicherstellen
3. Manuellen Trigger testen: Inject Node verwenden, um den Flow zu starten

Lösungen:

Ursache	Lösung	Prävention
Deaktivierte Flows	Auf Deploy → Full Deploy klicken	Regelmäßiges Deployment nach Änderungen
Unterbrochene Verbindungen	Nodes ordnungsgemäß neu verdrahten	Visuelle Inspektion während der Bearbeitung
Fehlkonfiguration des Timers	Timing-Einstellungen des Inject Node prüfen	Timing-Anforderungen dokumentieren
Ausfall des externen Triggers	I/O-Verkabelung und Signale überprüfen	Regelmäßige I/O-Tests

Problem: Flows laufen, aber liefern falsche Ergebnisse

Symptome:

• Nachrichten fließen, aber Klassifikationen sind falsch
• Pass/Fail-Logik funktioniert nicht korrekt
• Inkonsistente Ergebnisse

Diagnoseprozess:

1. Debug-Nodes hinzufügen vor und nach verdächtigen Nodes
2. Erwarteten vs. tatsächlichen Nachrichteninhalt vergleichen
3. Node-Konfigurationen auf korrekte Parameter prüfen

Lösungen:

Problembereich	Prüfen	Beheben
Classification Logic	ROI-Ausrichtung, Modelltraining	Neu trainieren oder ROI anpassen
Switch-Bedingungen	Eigenschaftsnamen und -werte	Switch-Logik korrigieren
Nachrichteneigenschaften	Datentypen und Formate	Change Node verwenden, um Format zu korrigieren
Kontextvariablen	Gespeicherte Werte und Gültigkeitsbereich	Kontextspeicher löschen/zurücksetzen

Performance-Probleme

Problem: Langsame Flow-Ausführung

Symptome:

• Verzögerungen zwischen Trigger und Ausgabe
• Inspektions-Timeouts
• Systemverzögerung

Performance-Diagnostik:

1. Debug-Zeitstempel prüfen, um langsame Nodes zu identifizieren
2. CPU-Auslastung am Kamerasystem überwachen
3. Aktive Debug-Nodes zählen (ungenutzte deaktivieren)

Optimierungsmaßnahmen:

Performance-Problem	Lösung	Erwartete Verbesserung
Zu viele Debug-Nodes	Ungenutzte Debug-Nodes deaktivieren/entfernen	10–20 % Geschwindigkeitssteigerung
Komplexe Function Nodes	JavaScript-Code optimieren	Variable Verbesserung
Hochfrequente Trigger	Verzögerung/Rate-Limiting hinzufügen	Systemüberlastung vermeiden
Große Nachrichtenobjekte	Größe der Nachrichten-Payload reduzieren	Schnellere Verarbeitung

Wartungsverfahren

Tägliche Funktionsprüfungen

Visuelle Flow-Inspektion (5 Minuten)

1. Node-RED Editor aufrufen
2. Auf Fehleranzeigen prüfen (rote Dreiecke)
3. Flow-Verbindungen auf Vollständigkeit prüfen
4. Aktuelle Debug-Meldungen auf Anomalien überprüfen

Flow-Ausführungstest (10 Minuten)

1. Manueller Auslösetest mit Inject-Nodes
2. Erwartete Ausgaben in der Debug-Seitenleiste überprüfen
3. Pass/Fail-Logik testen mit bekannten Gut-/Schlechtteilen
4. Externe Kommunikation bestätigen (PLC, Datenbanken)

Monatliche Wartungsaufgaben

Leistungsüberprüfung (15 Minuten)

Checkliste zur Flow-Optimierung:

Aufgabe	Aktion	Hinweise
Debug-Node-Bereinigung	Nicht verwendete Debug-Nodes deaktivieren	Nur wesentliches Debugging beibehalten
Context Storage Überprüfung	Unnötige gespeicherte Werte löschen	Speicheraufbau verhindern
Fehlerprotokoll-Überprüfung	Browser-Konsole auf Fehler prüfen	Wiederkehrende Probleme dokumentieren
Backup-Erstellung	Flows in Backup-Datei exportieren	Mit Datums-/Versionsinformationen speichern

Konfigurationsvalidierung (20 Minuten)

1. Aktuelle Flows vergleichen mit dokumentierten Standards
2. Alle kritischen Pfade prüfen auf angemessene Fehlerbehandlung
3. Fehlerwiederherstellungsszenarien testen
4. Dokumentation aktualisieren bei Änderungen

Monatliche Tiefenwartung

Umfassende Flow-Analyse (45 Minuten)

Erfassung von Leistungskennzahlen:

• Flow-Ausführungszeiten
• Analyse der Fehlerhäufigkeit
• Muster der Ressourcennutzung
• Kommunikationszuverlässigkeit

Überprüfung der Flow-Struktur:

• Redundante Nodes eliminieren
• Doppelte Logik konsolidieren
• Veraltete Konfigurationen aktualisieren
• Komplexe Function-Nodes optimieren

Backup- und Wiederherstellungstests (30 Minuten)

1. Vollständigen Flow-Export erstellen
2. Importverfahren testen auf Backup-System
3. Wiederherstellung des Backups prüfen auf Funktionsfähigkeit
4. Wiederherstellungsverfahren dokumentieren

Diagnosewerkzeuge und -techniken

Integrierte Node-RED Werkzeuge

Funktionen der Debug-Seitenleiste

Funktion	Anwendungsfall	Zugriffsmethode
Nachrichtenfilterung	Fokus auf bestimmte Nodes	Filter-Schaltfläche in der Seitenleiste
Nachrichtenverlauf	Die letzten 100 Nachrichten überprüfen	In Debug-Seitenleiste scrollen
Node-Lokalisierung	Quelle der Debug-Nachricht finden	Node-Namen in der Nachricht anklicken
Nachrichten-Export	Diagnosedaten speichern	Nachrichteninhalt kopieren

Context Data Explorer

Zugriff auf Context Storage:

• OV10i Node-RED Oberfläche öffnen (http://<camera-ip>/recipes/<recipe-number>/ioblock)
• Zum Tab Context Data wechseln (rechte Seitenleiste)
• Node-/Flow-/Global-Context-Werte anzeigen

Context-Debugging:

• Node Context: Zustand einzelner Nodes prüfen
• Flow Context: Gemeinsame Flow-Variablen überprüfen
• Global Context: Systemweite Einstellungen überprüfen

Test der Netzwerkkommunikation

Validierung von HTTP-Anfragen:

1. Externe Tools verwenden (Postman, curl) zum Testen von Endpunkten
2. Antwortformate überprüfen auf Übereinstimmung mit erwarteten Daten
3. Fehlerbedingungen testen (Timeouts, ungültige Antworten)

Überprüfung der PLC-Kommunikation:

1. PLC-Programmiersoftware verwenden zur Überprüfung der Konnektivität
2. Zugriff auf Datenregister unabhängig testen
3. Datenformatkonvertierungen validieren

Notfall-Wiederherstellungsverfahren

Wiederherstellung bei beschädigten Flows

Symptome einer Beschädigung:

• OV10i Node-RED-Oberfläche lädt keine Flows
• Flows erscheinen nach Kameraneustart leer
• Bereitstellung schlägt wiederholt fehl

Wiederherstellungsschritte:

1. Power Cycle der OV10i-Kamera:
   • Stromversorgung für 10 Sekunden trennen
   • Vollständigen Bootvorgang abwarten (alle 4 LEDs stabil)
2. Zugriff auf die Node-RED-Oberfläche des Rezepts:
   • Navigieren Sie zu http://<camera-ip>/recipes/<recipe-number>/ioblock
   • Falls Flows beschädigt sind, aus Backup importieren
3. Aus Backup wiederherstellen:
   • OV10i-Rezeptimportfunktion verwenden
   • Aktuellste Backup-Datei importieren
   • Alle Verbindungen auf Integrität prüfen
4. Wiederherstellung validieren:
   • Alle kritischen Flows testen
   • Externe Kommunikation überprüfen
   • Etwaige Konfigurationsänderungen aktualisieren

Probleme mit Systemressourcen

Speicher-/CPU-Überlastung

Sofortmaßnahmen:

1. Nicht erforderliche Debug-Nodes deaktivieren in OV10i Node-RED
2. Hochfrequente Timer-Trigger entfernen
3. Komplexe Function-Nodes vereinfachen
4. Power Cycle der Kamera durchführen, um alle Dienste neu zu starten

Langfristige Lösungen:

• Flow-Design für OV10i-Hardware optimieren
• Rate Limiting implementieren
• Nachrichten-Payload-Größen reduzieren
• Wartungsfenster planen

Checklisten zur Fehlerbehebung

Checkliste vor der Wartung

• Produktion über Wartungsfenster informieren
• Aktuelles Flow-Backup erstellen
• Aktuellen Systemzustand dokumentieren
• Rollback-Verfahren vorbereiten
• Backup-Wiederherstellungsprozess testen

Validierung nach der Wartung

• Alle Flows wurden erfolgreich bereitgestellt
• Manuelle Trigger-Tests bestanden
• Externe Kommunikation verifiziert
• Fehleranzeigen zurückgesetzt
• Leistung innerhalb des akzeptablen Bereichs
• Dokumentation aktualisiert

Checkliste für Notfallmaßnahmen

• Auswirkungen auf System bewertet
• Produktion benachrichtigt
• Schnelle Behebung versucht
• Backup-Wiederherstellung bei Bedarf
• Ursache identifiziert
• Präventivmaßnahmen umgesetzt

Dokumentation und Protokollierung

Wartungsaufzeichnungen

Erforderliche Dokumentation:

• Datum/Uhrzeit der Wartung
• Identifizierte und behobene Probleme
• Durchgeführte Konfigurationsänderungen
• Erreichte Leistungsverbesserungen
• Empfehlungen für die Zukunft

🔗 Siehe auch

• Node-RED Grundlagen
• Erstellen Ihres ersten Rezepts
• Kamera-Kommunikationsarchitektur
• Fehlerbehebung bei Stromproblemen
• Node-RED-Architektur in OV10i

---

tipp

Dokumentieren Sie alle Änderungen, die während der Debugging-Sitzungen vorgenommen werden. Dies erleichtert die zukünftige Fehlerbehebung und baut institutionelles Wissen für Ihr Team auf.