Foutafhandeling instellen in n8n
In n8n stel je foutafhandeling in via de 'Error Trigger'-node in een aparte error workflow, die je koppelt aan je productie-workflows. Daarnaast configureer je per node de retry-instellingen en kies je of de workflow stopt of doorgaat bij een fout. Zo vangt n8n fouten automatisch op en kun je er direct op reageren.
Met de Error Trigger node en retry-logica in n8n zorg je dat falende workflows automatisch worden opgevangen en gemeld.
Waarom foutafhandeling cruciaal is in n8n
Automatiseringsworkflows draaien onbeheerd. Als een externe API tijdelijk uitvalt, een verwacht veld ontbreekt of een authenticatietoken verloopt, faalt de workflow zonder dat iemand het merkt. Data gaat verloren, processen staan stil en het duurt soms dagen voor het probleem ontdekt wordt.
Goede foutafhandeling zorgt dat je direct een melding krijgt bij een probleem, dat tijdelijke fouten automatisch opnieuw worden geprobeerd, en dat je genoeg context hebt om de oorzaak snel te vinden. In n8n zijn hier specifieke mechanismen voor.
Stap 1: maak een error workflow aan
Een error workflow is een aparte n8n-workflow die als enige trigger de “Error Trigger”-node heeft. Deze node wordt automatisch geactiveerd wanneer een andere workflow een onverwerkte fout geeft.
In de error workflow voeg je notificatie-nodes toe. Stuur een e-mail of een bericht naar Slack of Teams met de naam van de falende workflow, de node waar de fout optrad en de foutmelding. De Error Trigger geeft deze informatie mee als JSON-data die je kunt gebruiken in je notificatieberichten.
Stap 2: koppel de error workflow
Open je productie-workflow en ga naar de workflow-instellingen via het tandwielpictogram rechtsonder. Stel bij “Error Workflow” de zojuist gemaakte error workflow in. Herhaal dit voor elke workflow die je wilt bewaken. Zodra een onverwachte fout optreedt, triggert n8n de error workflow automatisch.
Stap 3: configureer retry-logica per node
Voor nodes die externe API’s aanroepen, is het verstandig om retry-logica in te stellen. Klik op de node, ga naar “Settings” en schakel “Retry On Fail” in. Kies het aantal pogingen (1 tot 5) en de wachttijd tussen pogingen in seconden.
Dit is met name nuttig voor webhook-aanroepen naar diensten die soms een tijdelijke 429 (rate limit) of 503 (service unavailable) teruggeven. Met drie pogingen en een wachttijd van vijf seconden vang je de meeste tijdelijke storingen automatisch op.
Stap 4: Stop on Error versus Continue
In de node-instellingen kies je bij “On Error” hoe de workflow reageert op een fout in die node. De standaard is “Stop Workflow Execution”: de workflow stopt direct en geeft de fout door aan de error workflow.
De optie “Continue” laat de workflow doorgaan naar de volgende node, ook als deze node mislukt. Dit is handig bij batch-verwerking: als één item faalt, wil je niet dat de verwerking van alle andere items ook stopt.
Stap 5: gebruik Error Output pins
Sommige nodes ondersteunen een aparte “Error Output”-pin. Schakel deze in via de node-instellingen. Je krijgt dan twee uitvoerpaden: het normale pad voor succesvolle uitvoer en een foutpad voor items die niet verwerkt konden worden.
Verbind het foutpad met een node die de fout logt in een database of spreadsheet. Zo bouw je een register op van alle mislukte items, die je later handmatig kunt verwerken of opnieuw kunt aanbieden.
Stap 6: test de foutafhandeling
Simuleer een fout door een node een ongeldige URL of een leeg verplicht veld mee te geven. Voer de workflow handmatig uit en controleer of de error workflow wordt getriggerd, of de notificatie aankomt met de juiste context, en of de foutmelding voldoende informatie bevat om de oorzaak te traceren.
Onze tip: Geef elke workflow een unieke, beschrijvende naam. In de foutmelding van de error workflow staat die naam, en “Workflow 47” zegt je niets om 23:00 als je op je telefoon een melding krijgt. “Klantdata sync naar CRM - dagelijks” wel.
Veelgestelde vragen
Wat is het verschil tussen een error workflow en error output in n8n?
Een error workflow is een aparte workflow die wordt getriggerd als een andere workflow crasht, dus als er een onverwerkte uitzondering optreedt. Error output is een extra uitvoerpin op een specifieke node die actief wordt als die node een fout geeft, maar de rest van de workflow kan gewoon doorgaan. Gebruik error output voor verwachte fouten per item, en een error workflow als vangnet voor onverwachte crashes.
Hoe stuur ik foutmeldingen naar Slack vanuit n8n?
In je error workflow voeg je na de Error Trigger een Slack-node toe met de actie 'Send a Message'. Gebruik de data van de Error Trigger (zoals {{$json.workflow.name}} en {{$json.execution.error.message}}) om een informatieve melding te sturen. Zo weet je direct welke workflow is mislukt en wat de foutmelding was.
Hoe lang bewaart n8n de uitvoeringsgeschiedenis?
In de zelfgehoste versie van n8n sla je de uitvoeringsgeschiedenis op in je eigen database en bepaal je zelf de retentie. In n8n.cloud is de standaard bewaarperiode 7 dagen voor het gratis plan en 30 dagen voor betaalde plannen. Stel een opschoonstrategie in zodat de database niet onbeperkt groeit.