Kontrola zpětných odkazů zablokovala vydání: příklad poválební analýzy

Co tým kontroloval před vydáním

Velmi málo, jak se ukázalo. Seznam testů obsahoval pouze známé domény, proto zůstala mezera skrytá, dokud se neobjevil odkaz na partnera. Test na známém webu prokáže, že potrubí funguje, ale nevypoví nic o doméně, kterou index ještě neviděl.

Lepší seznamy testů by měly obsahovat tři typy domén: osvědčenou, malou specializovanou a doménu registrovanou nedávno. Všechny tři nechte projít webhookem, než mu kdokoli začne důvěřovat.

Jaké domény test pokrýval?

Pouze ty snadné. Každá doména v seznamu měla za sebou roky historie, takže každá odpověď byla kompletní a nikdo neviděl, jak prázdná odpověď ovlivní publikování.

Přidejte jednu skutečně novou doménu a přečtěte si její výsledek ručně. Pokud poznámka říká „špatně“ tam, kde by měla být „neznámá“, pravidlo je třeba před vydáním přepracovat.

Co vynechal stagingový běh?

Stagingový běh použil klíč se zdravým zůstatkem, takže cesta při vyčerpání zůstatku nikdy nebyla vykonána. Nikdo nevytvořil test, který by úmyslně vyčerpal kredit.

Mějte tuto cestu pod testem. Jednou za čtvrtletí vynutujte 402 a přečtěte si, co editor uvidí poté, protože cesta selhání, kterou nikdo nevyzkouší, je cestou, které nikdo nemůže důvěřovat.

Proč k tomu došlo

Brána považovala každou neúspěšnou odpověď za verdikt. To byla příčina. Problém s zůstatkem a neznámá doména jsou fakta o nástrojích a indexu, a ani jedno nevypovídá nic o stránce.

Náš graf je rebuildován přibližně jednou měsíčně. Doména registrovaná po poslední aktualizaci může vypadat prázdně a nový partner je u stránky pro vydání běžným případem. Nikdo to nekontroloval. Tým testoval webhook pouze se starými, dobře známými doménami, jako je nytimes.com.

Druhým selháním bylo ticho. Funkce chybu zalogovala, ale neposlala žádné upozornění a editor viděl obecnou chybovou zprávu bez nápovědy, že došel kredit.

Náklady nikdy nebyly problémem. Při ceně 2 kredity za volání vyšlo celoměsíční testování pro tuto smyšlenou stránku na přibližně $0,60, což je stejná částka jako řada s 3 000 publikacemi v tabulce nákladů. Brána byla levná a přesto stála tým hodinu práce v roce 2026.

402 si zaslouží vlastní řádek. Předplacený zůstatek je stav, který lze sledovat, takže jednoduchý alarm při 10 000 kreditech, což je $1, by se spustil dříve.

Jak byla oprava napsána

Tým rozdělil jednu obecnou chybu na tři, protože každá odpověď má jiného vlastníka. 401 je problém s klíčem, 402 je stav fakturace a prázdný výsledek pro novou doménu je prostě neznámý. Každá z nich má vlastní větev a vlastní zprávu. To je celá změna.

Nikdo nemusel číst stack trace, aby věděl, co se stalo. Název alertu pojmenovává stav a editor vidí větu, která říká, co dělat dál.

Proč je alarm pro zůstatek nastaven výrazně nad nulu?

Deset tisíc kreditů je při zveřejněné ceně $1, malá částka, která stále poskytuje dostatečné varování, když přijde dříve. Nastavte alarm tak, aby ho viděl člověk, ne v logu, který nikdo neotevře v pátek.

Kontrola, která jednou denně selže hlasitě, je lepší než tichá kontrola, která selže během vydání.

Ujednejte číslo s týmem a zapište ho na stejné místo jako pravidlo pro rotaci klíčů, aby se obě věc kontrolovaly společně.

Měla by se nová doména počítat jako selhání?

Ne. Doména, kterou index ještě neviděl, je fakt o indexu, ne o stránce. Uložte ji jako neznámou s datem a nechte editora rozhodnout, zda počkat na další aktualizaci.

Stejné pravidlo platí pro jakoukoli tenkou odpověď. Chápejte ji jako chybějící data a nikdy jako verdikt o partnerovi.

Logujte neznámé odpovědi do vlastního seznamu, aby byl jejich vzorec viditelný při příští revizi a nebyl pohřben v obecném logu.

Otázky, které si tým položil poté

Zástupčí schůzka zvedla stejnou hrst otázek v každé verzi tohoto příběhu. Zde je, jak si vymyšlený tým na ně odpověděl a proč by se tyto odpovědi lišily od organizace k organizaci.

Žádná z těchto odpovědí není univerzální a každá závisí na účelu stránky. Cílem je mít odpověď na papíře před dalším vydáním.

Měla by brána selhat uzavřeně?

Pro tento vymyšlený tým ne. Kontrola odkazů je signál založený na měsíčním indexu a neměla by být jedinou věcí mezi editorem a vydáním.

Napište politiku jako jednu větu, aby příští inženýr mohl rozlišit záměrné zablokování od chyby.

Zabránila by tomu větší částka?

Zpozdila by problém, nikoli by ho opravila. Větší zůstatek může také dojet a brána, která považuje každou neúspěšnou odpověď za verdikt, stále zablokuje na první neznámé doméně.

Opravou je rozdělení na tři odpovědi plus alarm, který se spustí včas. Zůstatek je jen jednou částí příběhu.

Položte stejnou otázku jakékoli bráně, kterou stavíte: které selhání by bylo tiché a kdo by ho zjistil jako první?

Poznámka k hypotetickému scénáři

Skutečné týmy se budou lišit. Váš tým může selhat uzavřeně ze dobrých důvodů, například u regulovaného webu, kde každý odchozí odkaz kontroluje člověk. V pořádku. Jen to musí být vědomá volba.

Runbook pro webhook uvádí stejná rozhodnutí jako kontrolní seznam a seznam mýtů pokrývá přesvědčení, která vedla tento vymyšlený tým do pasti.