InnerWeb
Přejít na obsah

Poller n8n a opakování: poznámky k nasazení

Zapnutí pollera je okamžik, kdy webhooky skutečně začínají odcházet z provozovny, takže chyby v nastavení stojí alarmy. Správce IT má před startem zkontrolovat čtyři věci: účet, potvrzení, opakování a jejich hranice. Níže je pořadí prací a úskalí, která je dobré znát předem.

89
záznamů v jednom balíku
Zdroj: karta
300 s
limit rezervace před vrácením do fronty
Zdroj: karta

Předpoklady před startem

Poller pracuje v režimu outbox, takže prvním předpokladem je přepnutí nastavení režimu doručování webhooků. Každá hodnota jiná než outbox znamená direct, proto je po změně nutné provést testovací událost a potvrdit, že se záznam objevil v tabulce, a nikoli že odešel přímo.

Druhým předpokladem je technický účet pro poller s rozsahem omezeným na vyzvedávání záznamů a potvrzování doručení. Třetím je síťový segment, ze kterého má poller přístup k aplikaci příchozím kanálem a ke koncovému příjemci. Čtvrtým je určený vlastník workflow na straně IT.

Jak funguje cyklus vyzvednutí a potvrzení

Poller vyzvedává čekající záznamy a systém atomicky rezervuje balík až 89 záznamů pod zámkem zápisu v transakci. Dva pollery tak nevyzvednou stejný záznam a alarm nezazvoní dvakrát. Po odeslání poller potvrdí každý záznam jako delivered nebo failed s volitelným popisem chyby.

Potvrzení je idempotentní: opakování potvrzení záznamu, který je už doručen, nic nemění. To je důležité při výpadcích sítě, protože poller může bezpečně zopakovat potvrzení, pokud nedostal odpověď.

Kdy se záznam vrací do fronty

Záznam ve stavu doručování, jehož rezervace trvá déle než 300 sekund, se vrací do fronty a může být vyzvednut znovu. V praxi to znamená, že odeslání jednoho balíku by nemělo trvat déle než několik minut a workflow by mělo mít vlastní časový limit kratší než 300 sekund. Jinak bude stejný balík zpracován podruhé, zatímco první ještě běží.

Hranice mechanismu pollera

Hranice mechanismu polleraSloupcový graf: 89 záznamů v balíku, rezervace 300 sekund, limit pokusů nula, tedy žádný limit.0100200300hodnotaZáznamů v balíku: 89 hodnota89Záznamů v balíkuRezervace (s): 300 hodnota300Rezervace (s)Limit pokusů (žádný = 0): 0 hodnota0Limit pokusů (žádný = 0)
Zdroj: Popis funkce Webhook Outbox (dokumentace produktu); nula znamená, že systém nemá limit pokusů

Opakování a jejich hranice

Neúspěšné potvrzení failed vrátí záznam do stavu čekajícího a zvýší čítač pokusů. Poller tedy záznam opakuje bez konce. Toto chování je výhodou pro alarmy, které nesmějí zaniknout, ale má hranice, o kterých je třeba vědět před spuštěním.

Systém nemá limit pokusů, odstup mezi opakováními ani upozornění na uvízlé záznamy. Záznam, který příjemce trvale odmítá, například kvůli chybné adrese, bude vyzvedáván a vracen dokola, zatěžuje poller a zaplňuje protokol. Chybějící mechanismy je třeba nahradit postupem na straně workflow: vlastním počítadlem pokusů v n8n, odstupem mezi pokusy a upozorněním, když se záznam opakuje příliš mnohokrát.

Pořádek v tabulce a dohled

Žádná úloha tabulku nečistí, takže ukončené záznamy přibývají bez konce. Správce by měl stanovit politiku uchovávání: jak dlouho ukončené záznamy ponechat a kdo je maže. Bez toho se tabulka v instalaci s velkým provozem po několika měsících promění v problém s výkonem.

Pro dohled stačí tři ukazatele: počet čekajících záznamů, stáří nejstaršího čekajícího záznamu a počet pokusů nejčastěji opakovaného záznamu. Alarm by měl reagovat na stáří nejstaršího čekajícího záznamu, protože ukazuje, že poller stojí nebo příjemce neodpovídá.

Pořadí spuštění a převzetí

Doporučené pořadí: nejdřív testovací prostředí s fiktivním příjemcem, pak testovací událost s potvrzením delivered, poté negativní zkouška s příjemcem, který událost odmítá (ověření, jak se chová počítadlo pokusů), a nakonec přepnutí na produkčního příjemce.

Převzetí se uzavírá protokolem: nastavený režim, účet a rozsah, časový limit workflow, ukazatele dohledu, politika uchovávání a vlastník. Každý z těchto bodů má důkaz v podobě výpisu konfigurace nebo záznamu v protokolu.

Kontrolní seznam

Videomateriál

Často kladené otázky

Kolikrát poller zopakuje neúspěšný záznam?

Bez konce. Systém nemá limit pokusů ani odstup mezi opakováními, takže omezení je nutné zavést ve workflow.

Mohou dva pollery běžet paralelně?

Ano. Rezervace balíku je atomická, takže dva pollery nevyzvednou stejný záznam.

Kdo čistí tabulku s ukončenými záznamy?

Žádná úloha systému. Správce musí stanovit politiku uchovávání a ukončené záznamy pravidelně mazat.

Poller pod dohledem

Připravíme s vaším IT oddělením plán spuštění pollera: limity, dohled a protokol převzetí.

Pojďme si promluvit