TL;DR:

Workflow błędów (Error Workflow) to kluczowy mechanizm uruchamiany automatycznie przy wystąpieniu błędu w dowolnym węźle
Błędy można też celowo wywoływać za pomocą węzła Stop and Error dla obsługi nieprawidłowych danych
Dziennik wykonań (execution log) przechowuje historię wszystkich wykonań workflow i pomaga w diagnozowaniu problemów
Dla każdego nowego workflow warto skonfigurować osobny workflow błędów do raportowania problemów
Błędy powinny być zgłaszane do dedykowanego kanału komunikacji (np. Slack, Teams, email)
W węzłach Stop and Error można skonfigurować różne zachowania – od całkowitego zatrzymania workflow po kontynuację z obsługą błędu
Współpraca w n8n opiera się na udostępnianiu workflow i poświadczeń, z zachowaniem odpowiednich uprawnień dla różnych poziomów użytkowników

Dlaczego obsługa błędów w n8n jest tak ważna?

Automatyzacja procesów to potężne narzędzie, ale bez odpowiedniej obsługi błędów może stać się źródłem problemów. Kiedy aktywujemy workflow w n8n, działa on w tle, wykonując zaplanowane zadania. Co się jednak stanie, gdy dane wejściowe będą nieprawidłowe lub połączenie z zewnętrznym API zawiedzie? Właśnie dlatego efektywna obsługa błędów jest jedną z najważniejszych umiejętności przy budowaniu niezawodnych automatyzacji w n8n.

Przechowywanie historii wykonań workflow

Zanim zagłębimy się w metody obsługi błędów, warto zrozumieć, jak n8n przechowuje informacje o wykonaniach workflow.

Dziennik wykonań (execution log)

W dotychczasowej pracy z n8n prawdopodobnie wykonywałeś workflow ręcznie, klikając „Execute workflow” lub „Test step”. Jednak po aktywacji workflow, automatyzacja działa w tle. Wszystkie te wykonania są zapisywane w dzienniku wykonań (execution log), do którego masz dostęp klikając „All executions”.

Co warto wiedzieć o dzienniku wykonań:

Domyślnie zapisuje tylko wykonania produkcyjne (z aktywowanych workflow)
Rejestruje zarówno wykonania udane jak i zakończone błędem
Wykonania ręczne nie są zapisywane automatycznie
Można włączyć zapisywanie wykonań ręcznych dla poszczególnych workflow
Dziennik można sortować według statusu, dat lub danych wykonania

Analiza historii wykonań

Każde wykonanie zapisane w dzienniku stanowi „zrzut” końcowego stanu wszystkich węzłów. Jest to nieocenione narzędzie podczas:

Debugowania problemów
Naprawiania błędów
Analizowania działania workflow
Zrozumienia, jak działa workflow stworzony przez kogoś innego

Możesz otworzyć każdy węzeł poprzez podwójne kliknięcie, aby zobaczyć:

Dane wejściowe i wyjściowe
Ustawienia węzła
Szczegóły błędu (jeśli wystąpił)

Główne metody obsługi błędów w n8n

1. Workflow błędów (Error Workflow)

Najważniejszym mechanizmem obsługi błędów w n8n jest workflow błędów. Jest to specjalny workflow, który uruchamia się automatycznie, gdy dowolny węzeł napotka błąd.

Kluczowe cechy workflow błędów:

Informuje zespół o wystąpieniu problemu
Dostarcza informacje potrzebne do debugowania
Musi być skonfigurowany dla każdego nowego workflow

Co zawiera workflow błędów:

Nazwę i ID workflow, w którym wystąpił błąd
ID wykonania
Linki do konkretnego wykonania z błędem
Informacje o węźle, który spowodował błąd
Szczegółowy komunikat błędu

Przykład z praktyki: workflow uruchamiany codziennie o 8:00 odczytuje kontakty z Google Sheets i aktualizuje CRM Salesforce. Ponieważ pole email jest obowiązkowe w Salesforce, próba utworzenia kontaktu bez adresu email powoduje błąd. To z kolei uruchamia workflow błędów, który informuje o problemie.

2. Węzeł Stop and Error

Drugą metodą jest węzeł Stop and Error, który wywołuje błąd za każdym razem, gdy jest uruchamiany. Możesz skonfigurować własną wiadomość błędu.

Opcje konfiguracji zachowania po błędzie:

Stop workflow (domyślnie) – zatrzymuje cały workflow
Continue – kontynuuje workflow pomimo błędu
Continue using error output – kontynuuje workflow, ale za pomocą wyjścia błędu

Węzeł Stop and Error jest idealny do obsługi przypadków brzegowych, gdy określone warunki nie powinny wystąpić. Na przykład, możesz zgłosić błąd, gdy dane z webhooka nie zawierają poprawnego adresu email.

Checklist: Jak stworzyć efektywny workflow błędów

Praktyczne przykłady obsługi błędów

Weźmy jako przykład workflow obsługujący webhooki, który reaguje na różne typy zdarzeń (np. „account created” lub „team member invited”). Możemy zidentyfikować dwa potencjalne źródła błędów:

Wzorce walidacji danych, które warto wdrożyć:

1. Walidacja adresu email:

Najprostszym sposobem sprawdzenia poprawności adresu email jest sprawdzenie, czy zawiera symbol „@”:

IF email zawiera "@"
  -> Kontynuuj workflow
ELSE
  -> Stop and Error z komunikatem "Invalid email"

Bardziej zaawansowane podejście mogłoby wykorzystać wyrażenia regularne do dokładniejszej walidacji.

2. Walidacja zdarzeń systemowych:

Możemy również sprawdzić, czy typ zdarzenia jest prawidłowy:

SWITCH(event)
  CASE "account created" -> wykonaj akcję A
  CASE "team member invited" -> wykonaj akcję B
  CASE event nie istnieje lub event == "" -> Stop and Error z komunikatem "Invalid event"

3. Inne przydatne walidacje:

Sprawdzanie, czy wymagane pola są obecne
Weryfikacja poprawności formatu danych
Kontrola, czy wartości mieszczą się w dozwolonym zakresie
Weryfikacja, czy zdarzenie zawiera wszystkie wymagane parametry
Kontrola, czy zdarzenie pochodzi z autoryzowanego źródła

Współpraca i udostępnianie w n8n

Społeczność n8n

Społeczność n8n to wyjątkowy zasób, który wyróżnia tę platformę na tle innych rozwiązań do automatyzacji. Jest bardzo aktywna i pomocna.

Co oferuje społeczność n8n:

Forum do zadawania pytań i zgłaszania problemów
Bibliotekę gotowych szablonów workflow
Możliwość zgłaszania pomysłów na nowe funkcje
Szybkie wsparcie techniczne
Wydarzenia społecznościowe
Wymianę doświadczeń z innymi użytkownikami

Wsparcie zazwyczaj odpowiada bardzo szybko, co pozwala uniknąć przestojów podczas budowania workflow.

Szablony workflow

Społeczność pomogła zbudować bibliotekę szablonów, które obejmują szeroką gamę typowych problemów automatyzacji. Zamiast zaczynać od zera, możesz wykorzystać gotowe rozwiązania:

Endpoints API
Kopie zapasowe workflow n8n do GitHub
Chatboty
Ekstrakcja tekstu z PDF
I wiele innych

Szablony znajdziesz na n8n.io/workflows lub bezpośrednio w interfejsie n8n. Możesz je sortować według kategorii, wyszukiwać według nazwy lub typu węzła. Zawsze sprawdź szablony przed rozpoczęciem budowy workflow – mogą zaoszczędzić mnóstwo czasu.

Poziomy uprawnień użytkowników w n8n:

Rola	Kluczowe uprawnienia	Ograniczenia
Owner	Pełen dostęp do wszystkich workflow i poświadczeń	Tylko jeden na instancję
Admin	Podobnie jak Owner, ale bez dostępu do dashboardu n8n Cloud	Nie może zarządzać rolą właściciela
Member	Zarządzanie własnymi kontami i workflow	Ograniczony dostęp do workflow i poświadczeń innych

Właściciel i administratorzy mają dostęp do udostępniania poświadczeń, ale nie mogą odczytać wrażliwych informacji (np. kluczy API).

Checklist: Bezpieczne udostępnianie workflow i poświadczeń

Zidentyfikuj, którzy członkowie zespołu potrzebują dostępu do danego workflow
Dla każdego workflow, wybierz opcję udostępniania w prawym górnym rogu płótna workflow
Dodaj odpowiednich członków zespołu jako edytorów
Upewnij się, że wszystkie niezbędne poświadczenia zostały udostępnione
Sprawdź, czy edytorzy mogą uruchamiać workflow (wykonaj test razem z nimi)
Regularnie przeglądaj uprawnienia i usuwaj dostęp dla osób, które go już nie potrzebują
Dokumentuj, kto ma dostęp do których workflow i poświadczeń
Dla poświadczeń, używaj opcji udostępniania w menu poświadczeń
Pamiętaj, że udostępnianie workflow automatycznie udostępnia używane w nim poświadczenia

Przy budowie workflow masz możliwość udostępniania lub ograniczania dostępu do workflow różnym członkom zespołu. Zaleca się, aby tylko odpowiedni użytkownicy mieli dostęp do określonych workflow, aby uniknąć niechcianych zmian.

Udostępnianie workflow:

Użytkownicy mogą udostępniać stworzone przez siebie workflow
Właściciele instancji lub administratorzy mogą przeglądać i udostępniać wszystkie workflow
Domyślnie członek bez udostępnionego workflow nie będzie miał do niego dostępu

Istnieją dwie role w kontekście workflow:

Creator – użytkownik, który utworzył workflow
Editor – inni użytkownicy z dostępem do workflow

Udostępnianie poświadczeń:

Pozwala udostępniać utworzone przez siebie poświadczenia innym użytkownikom
Inni użytkownicy mogą używać poświadczeń, ale nie mogą uzyskać dostępu ani edytować szczegółów
To kluczowe dla bezpieczeństwa – nikt nie może wyodrębnić tokenów aplikacji lub kluczy API

API n8n

N8n oferuje własne API, które umożliwia:

Używanie węzła n8n do zarządzania innymi workflow n8n
Dostęp, tworzenie i edycję workflow n8n z zewnętrznych programów

Możliwości API n8n:

Programowe zarządzanie workflow (aktywacja/dezaktywacja)
Pobieranie i analiza dzienników wykonań
Automatyzacja tworzenia i modyfikacji workflow
Integracja z zewnętrznymi systemami monitoringu
Automatyzacja procesu tworzenia kopii zapasowych workflow

Aby korzystać z API n8n:

Przejdź do Ustawień > n8n API
Wygeneruj nowy klucz API
Użyj go do uwierzytelniania w API n8n

API oferuje endpointy do:

Pobierania/usuwania dzienników wykonań
Tworzenia/aktualizowania/usuwania workflow
Aktywacji/dezaktywacji workflow
Tworzenia/usuwania poświadczeń

Przykładowy przypadek użycia: workflow uruchamiany tylko w godzinach pracy (8:00-18:00), gdzie supporting workflow dezaktywuje go o 18:00 i reaktywuje o 8:00.

Podsumowanie

Obsługa błędów w n8n to kluczowy element budowania niezawodnych automatyzacji. Dzięki workflow błędów, węzłom Stop and Error oraz umiejętnemu zarządzaniu współpracą, możesz tworzyć solidne rozwiązania, które będą działały niezawodnie nawet w przypadku nieprzewidzianych problemów.

Konfigurując workflow błędów z odpowiednim raportowaniem na kanałach komunikacyjnych, zapewniasz szybką reakcję na problemy. Jednocześnie, wykorzystując zasoby społeczności i szablony, możesz znacznie przyspieszyć proces tworzenia efektywnych automatyzacji.

Ten artykuł jest częścią serii notatek z wartościowych webinarów. Powstał na podstawie transkryptu z kursu n8n dla początkujących (części 1-3). Materiały źródłowe: n8n Beginner Course

Tag: Error Trigger

Zaawansowana automatyzacja z n8n 2/3 #EN73

Podstawy automatyzacji z n8n – Obsługa błędów 3/3 #EN71