Proč jsou opakování běžná
V režimu outbox 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. Neúspěšné potvrzení vrátí záznam do stavu čekajícího a zvýší čítač pokusů. Při takové konstrukci koncový přijímač čas od času uvidí stejný obsah podruhé, a žádný z těchto mechanismů není chyba.
Záruka je tedy typu alespoň jednou, nikoli přesně jednou. U alarmu je to správná volba: raději dostat alarm dvakrát než vůbec. Cenu této volby nese příjemce, který musí být odolný vůči opakování.
Postup 1 až 3: klíč události a značka
První postup: určete klíč identifikující událost. Nejlépe kombinaci typu události, identifikátoru objektu a času události. U událostí recepce každý obsah nese čas ve formátu ISO 8601 v časovém pásmu Europe/Warsaw, takže lze takový klíč sestavit bez dotazů do zdrojového systému.
Druhý: zapisujte značku zpracování atomicky dříve, než provedete vedlejší účinek. Vzor použitý v samotném systému je značka SET NX v Redisu, která blokuje duplicity upozornění o neabsolvování školení. Nastavení značky je atomická operace: ji získá jen první příjemce, další vidí, že záznam je obsazen.
Třetí: značku uvolněte, pokud provedení selhalo. Systém přesně tak postupuje: neúspěšné odeslání uvolní zámek, aby upozornění mohlo odejít znovu. Přijímač, který událost označí jako vyřízenou ještě před provedením akce a po chybě značku nevrátí, promění přechodný výpadek v trvalou ztrátu alarmu.
Parametry, na kterých závisí opakování
Postup 4 a 5: potvrzení a pořadí
Čtvrtý: potvrzujte doručení na konci a počítejte s idempotencí potvrzení. Potvrzení přijímá stav delivered nebo failed s volitelným popisem chyby a potvrzení záznamu, který už je doručen, nic nemění. Přijímač tak může bezpečně zopakovat potvrzení po ztrátě síťové odpovědi.
Páté: nepředpokládejte pořadí. Vyzvednutí balíku rezervuje až 89 záznamů atomicky, ale pořadí doručení koncovým příjemcům závisí na pollerovi a síti. U událostí o změně stavu (aktualizace skupiny, poté přerušení) by měl příjemce porovnávat čas události, a ne pořadí příchodu.
Postup 6 a 7: odolnost vůči chybám a pozorovatelnost
Šesté: chyba přijímače nesmí zastavit zdroj. Systém odesílá události recepce asynchronně s limitem 5 sekund, aby výpadek webhooku nepřerušil registraci hosta. Přijímač by na své straně měl odpovídat rychle a zpracovávat na pozadí, místo aby držel spojení až do konce složité akce.
Sedmé: zaznamenávejte každou událost s klíčem a výsledkem (zpracováno, přeskočeno jako duplicita, chyba). Bez toho nelze odlišit ztrátu zprávy od správného odmítnutí opakování. U integrací s protokolem výměny by tento záznam měl být oddělen od aplikačního protokolu.
Typické chyby, které u přijímačů vidíme
Nejčastější chyba je deduplikace podle obsahu textu zprávy místo podle klíče události: dva různé alarmy se stejným textem se pak sloučí do jednoho. Druhá je značka s nulovou dobou života, která umožní opětovné zpracování po restartu. Třetí je potvrzování doručení před provedením akce, takže neúspěšná akce se nikdy nezopakuje.
Před nasazením přijímače do produkce odešlete stejnou událost dvakrát a ověřte, že se v kanálu objeví jeden zápis a v protokolu jeden záznam o zpracování a jeden o přeskočení.
Kontrolní seznam
Videomateriál
Často kladené otázky
Zaručuje systém doručení přesně jednou?
Ne. Mechanismy opakování dávají doručení alespoň jednou, takže přijímač by měl být idempotentní.
Čím nejlépe deduplikovat události?
Klíčem složeným z typu události, objektu a času události. Obsah textu není dobrý klíč.
Co když přijímač potvrdí doručení dvakrát?
Nic špatného. Potvrzení záznamu, který už je doručen, nic nemění.
Přijímač odolný vůči opakování
Spolu s vaším integrátorem projdeme test dvojité události a protokol zpracování.
Pojďme si promluvit