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
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