InnerWeb
Przejdź do treści

Poller n8n i ponowienia: uwagi wdrożeniowe

Włączenie pollera to moment, w którym webhooki zaczynają naprawdę wychodzić z zakładu, więc błędy konfiguracji kosztują alarmy. Administrator IT powinien przed startem sprawdzić cztery rzeczy: konto, potwierdzenia, ponowienia i ich granice. Poniżej kolejność prac i pułapki, które warto znać wcześniej.

89
wpisów w jednej paczce
Źródło: karta
300 s
limit rezerwacji przed zwrotem do puli
Źródło: karta

Warunki wstępne przed startem

Poller działa w trybie outbox, więc pierwszym warunkiem jest przełączenie ustawienia trybu doręczania webhooków. Każda wartość inna niż outbox oznacza direct, dlatego po zmianie należy wykonać zdarzenie testowe i potwierdzić, że wpis pojawił się w tabeli, a nie wyszedł bezpośrednio.

Drugi warunek to konto techniczne dla pollera z zakresem ograniczonym do pobierania wpisów i potwierdzania dostaw. Trzeci to segment sieci, z którego poller ma dostęp do aplikacji kanałem przychodzącym i do odbiorcy końcowego. Czwarty to wskazany właściciel workflow po stronie IT.

Jak działa cykl pobrania i potwierdzenia

Poller pobiera oczekujące wpisy, a system atomowo rezerwuje paczkę do 89 wpisów pod blokadą zapisu w transakcji. Dzięki temu dwa pollery nie odbiorą tego samego wpisu i alarm nie zadzwoni dwa razy. Po wysyłce poller potwierdza każdy wpis jako delivered albo failed z opcjonalnym opisem błędu.

Potwierdzenie jest idempotentne: powtórka potwierdzenia wpisu już doręczonego nic nie zmienia. To ważne przy awariach sieci, bo poller może bezpiecznie powtórzyć potwierdzenie, gdy nie dostał odpowiedzi.

Kiedy wpis wraca do puli

Wpis w stanie dostarczania, którego rezerwacja trwa dłużej niż 300 sekund, wraca do puli i może zostać odebrany ponownie. W praktyce oznacza to, że wysyłka pojedynczej paczki nie powinna trwać dłużej niż kilka minut, a workflow powinien mieć własny limit czasu krótszy od 300 sekund. W przeciwnym razie ta sama paczka zostanie przetworzona drugi raz, gdy pierwsza jeszcze trwa.

Granice mechanizmu pollera

Granice mechanizmu polleraWykres słupkowy: 89 wpisów w paczce, rezerwacja 300 sekund, limit prób zero, czyli brak limitu.0100200300wartośćWpisów w paczce: 89 wartość89Wpisów w paczceRezerwacja (s): 300 wartość300Rezerwacja (s)Limit prób (brak = 0): 0 wartość0Limit prób (brak = 0)
Źródło: Opis funkcji Webhook Outbox (dokumentacja produktu); zero oznacza brak limitu prób w systemie

Ponowienia i ich granice

Nieudane potwierdzenie failed cofa wpis do stanu oczekującego i zwiększa licznik prób. Poller ponawia więc wpis bez końca. To zachowanie jest zaletą dla alarmów, które nie mogą zginąć, ale ma granice, o których trzeba wiedzieć przed uruchomieniem.

System nie ma limitu prób, odstępu między ponowieniami ani alertu o wpisach utkniętych. Wpis, którego odbiorca trwale odrzuca, na przykład z powodu błędnego adresu, będzie pobierany i zwracany w kółko, obciążając poller i zaśmiecając dziennik. Brakujące mechanizmy trzeba zastąpić procedurą po stronie workflow: własnym licznikiem prób w n8n, odstępem między próbami i alertem przy wpisie powtarzanym zbyt wiele razy.

Porządek w tabeli i nadzór

Nie ma zadania czyszczącego tabelę, więc zakończone wpisy rosną bez końca. Administrator powinien określić politykę retencji: jak długo przechowywać wpisy zakończone i kto je usuwa. Bez tego tabela w instalacji o dużym ruchu zamieni się w problem wydajności po kilku miesiącach.

Do nadzoru wystarczą trzy wskaźniki: liczba wpisów oczekujących, wiek najstarszego wpisu oczekującego i liczba prób najbardziej ponawianego wpisu. Alarm powinien wyzwalać wiek najstarszego wpisu, bo to on mówi, że poller stoi albo odbiorca nie odpowiada.

Kolejność uruchomienia i odbiór

Zalecana kolejność: najpierw środowisko testowe z fikcyjnym odbiorcą, potem zdarzenie testowe z potwierdzeniem delivered, potem próba negatywna z odbiorcą odrzucającym zdarzenie (sprawdzenie, jak zachowuje się licznik prób), na końcu przełączenie na odbiorcę produkcyjnego.

Odbiór kończy się protokołem: ustawiony tryb, konto i zakres, limit czasu workflow, wskaźniki nadzoru, polityka retencji i właściciel. Każdy z tych punktów ma dowód w postaci zrzutu konfiguracji lub wpisu w dzienniku.

Lista kontrolna

Materiał wideo

Często zadawane pytania

Ile razy poller ponowi nieudany wpis?

Bez końca. System nie ma limitu prób ani odstępu między ponowieniami, więc ograniczenia trzeba wprowadzić w samym workflow.

Czy dwa pollery mogą działać równolegle?

Tak. Rezerwacja paczki jest atomowa, więc dwa pollery nie odbiorą tego samego wpisu.

Kto czyści tabelę z zakończonymi wpisami?

Żadne zadanie systemu. Administrator musi ustalić politykę retencji i okresowo usuwać zakończone wpisy.

Poller pod nadzorem

Przygotujemy z Twoim działem IT plan uruchomienia pollera: limity, nadzór i protokół odbioru.

Porozmawiajmy