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