InnerWeb
Przejdź do treści

Tryb direct czy outbox: który wybrać dla webhooków

Ustawienie trybu doręczania webhooków ma dwie wartości i dwie różne filozofie: direct wysyła od razu z serwera aplikacji, outbox zapisuje wpis i czeka na odbiór przez poller. Wybór zależy głównie od tego, czy sieć instalacji pozwala na ruch wychodzący. Poniżej siedem rekomendacji dla dyrektora IT, integratora i administratora aplikacji.

2
tryby doręczania: direct i outbox
Źródło: karta
4
miejsca systemu wysyłające webhooki
Źródło: karta

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