Dla kogo jest ta rekomendacja
Tekst jest przeznaczony dla osób, które decydują, jak webhooki z systemu InnerWeb mają docierać do odbiorców: dyrektora IT, integratora oraz administratora aplikacji. Zakłada się, że odbiorca (n8n, system zakładowy, komunikator) już istnieje i trzeba wybrać sposób dostarczenia.
Przełącznik to ustawienie trybu doręczania webhooków z wartościami direct (domyślna) i outbox. Każda inna wartość niż outbox oznacza direct, co ma znaczenie przy literówkach opisanych w rekomendacji szóstej.
Rekomendacje 1–3: wybór trybu
Poniżej trzy rekomendacje o charakterze decyzyjnym. Każda ma uzasadnienie wynikające z opisu mechanizmów.
1. Instalacja z ruchem wychodzącym: zostań przy direct
Tryb domyślny jest najprostszy: serwer aplikacji sam wysyła webhook do odbiorcy. Nie wymaga dodatkowego komponentu, który trzeba nadzorować. Jeśli sieć instalacji, na przykład w chmurze, pozwala na połączenia wychodzące do adresu odbiorcy, nie ma powodu dokładać pollera.
2. Sieć z blokadą ruchu wychodzącego: wybierz outbox
Tryb outbox powstał dla instalacji on-premise, w których sieć blokuje cały ruch wychodzący z hosta aplikacji, a webhook alarmowy przy wysyłce bezpośredniej kończył się przekroczeniem czasu i był tracony. Poller sam łączy się z aplikacją kanałem przychodzącym, więc zapora pozostaje bez zmian.
3. Webhook alarmowy: ważniejsza dostarczalność niż prostota
Jeśli przez webhook idą alarmy bezruchu lub inne zdarzenia bezpieczeństwa, strata komunikatu jest kosztowna. W takim przypadku wybór outbox ma sens także tam, gdzie sieć formalnie przepuszcza ruch, ale jest niestabilna: wpis czeka w tabeli, zamiast zginąć.
Rekomendacje 4–5: skutki dla raportów i nadzoru
Czwarta rekomendacja: zdecyduj, skąd weźmiesz historię dla raportu Kanały komunikacji. W trybie direct każdy webhook zapisuje dodatkowo zakończony wiersz delivered lub failed jako historię dla tego raportu, a taki wiersz nigdy nie trafia do pollera. W trybie outbox historię tworzą same wpisy, których stan zmienia się wraz z potwierdzeniami.
Piąta: przy outbox wyznacz właściciela pollera. Tryb przenosi odpowiedzialność za dostarczenie z aplikacji na workflow, który musi być monitorowany. Brak limitu prób, odstępu między ponowieniami i alertu o wpisach utkniętych oznacza, że nieudane potwierdzenie cofa wpis do oczekujących i zwiększa licznik prób, więc zdarzenie nie dostarczone będzie ponawiane bez końca.
Rekomendacje 6–7: zmiana trybu i porządki
Szósta: po zmianie trybu zawsze wykonaj zdarzenie testowe. Ponieważ każda wartość inna niż outbox oznacza direct, literówka w ustawieniu cicho przywróci wysyłkę bezpośrednią, a w sieci z blokadą webhook zostanie utracony bez widocznego błędu po stronie użytkownika.
Siódma: zaplanuj czyszczenie. Nie ma zadania, które usuwa zakończone wpisy z tabeli, więc rosną bez końca. Przy dużym ruchu webhooków trzeba ustalić okresowy przegląd i politykę retencji po stronie administratora.
Porównanie w jednym miejscu
Dla skrótu: direct wygrywa prostotą i nie wymaga pollera, ale wymaga ruchu wychodzącego z hosta aplikacji i nie ponawia zgubionych komunikatów. Outbox wygrywa dostarczalnością i zgodnością z zaporą, ale wymaga nadzoru nad pollerem i ręcznego przeglądu tabeli.
Najczęstszy błąd decyzyjny to wybór outbox dla samej niezawodności bez przypisania właściciela pollera. Drugi to zostawienie direct w sieci z blokadą z nadzieją, że wyjątek w zaporze zostanie dodany później.
Materiał wideo
Często zadawane pytania
Który tryb jest domyślny?
Domyślny jest direct. Każda wartość ustawienia inna niż outbox jest traktowana jak direct.
Czy w trybie direct mam historię w raporcie Kanały komunikacji?
Tak. Każdy webhook zapisuje dodatkowo zakończony wiersz delivered lub failed jako historię dla tego raportu.
Czy można zmieniać tryb w trakcie pracy?
Ustawienie można zmienić, ale po zmianie wykonaj zdarzenie testowe i sprawdź, czy wpis trafił zgodnie z oczekiwaniem.
Nie wiesz, który tryb wybrać?
Opisz nam sieć instalacji. Dobierzemy tryb doręczania i wskażemy, kto powinien nadzorować poller.
Porozmawiajmy