Calls om de domainscore te controleren die falen: 401, 402 en lege rijen

Volgorde van diagnose

Begin met de statuscode. Een 401 gaat over identiteit en een 402 over geld. Ze worden op verschillende plekken opgelost.

Lees dan ok. Elke response bevat dit. Bij geauthenticeerde calls toont _credits de kosten en het resterende saldo, zodat een leeg saldo zichtbaar is voordat de 402 verschijnt.

Houd deze volgorde vast in je runbook. Iedereen die direct naar de data springt, kan een ochtend kwijt zijn aan een probleem dat de statuscode direct had aangewezen.

Pas daarna mag je de data verdenken. Een jonge site toont vaak een lage DR. De oorzaak is zelden een bug. De waarschijnlijke reden is een maandelijkse snapshot die ouder is dan de links. Vergelijk de waarde met de formule-invoer.

Een sleutelprobleem scheiden van een saldo-probleem

Een 401 en een 402 lijken op elkaar in een script, omdat ze beide dezelfde lus stoppen. Ze hebben verschillende oorzaken, dus splits ze voordat je iets verandert.

Begin met een gratis actie op hetzelfde domein. Als deze antwoordt en de betaalde call niet, dan is het domein in orde en zit het probleem in de sleutel of het saldo.

Wanneer een 401 volgt na een kopie

Een sleutel die met een spatie aan het eind of een afgekapt einde is gekopieerd, is een veelvoorkomende oorzaak van een 401. Sleutels beginnen met sk_, dus controleer dat prefix en vergelijk de hele string met de kopie op de accountpagina.

Vervang de sleutel op één plek en voer dezelfde enkele call opnieuw uit. Meerdere dingen tegelijk veranderen maakt het resultaat onleesbaar.

Wanneer een 402 verschijnt na een top-up

Een 402 betekent dat de betaalde actie geen krediet meer heeft. Lees het resterende saldo in _credits op de volgende geauthenticeerde response voordat je iets anders doet.

Als dat saldo er goed uitziet, vergelijk het dan met de kosten van de call die faalde. De cijfers tonen aan of de call simpelweg groter is dan het saldo.

Noteer het tijdstip van je top-up, zodat de log en het saldo later met elkaar kunnen worden vergeleken.

Een korte notitie van het saldo voor en na elke top-up maakt de volgende 402 makkelijker te lezen.

Waarom een score verkeerd kan lijken zonder fout

Soms komen alle velden op tijd aan en verrast het getal je nog steeds. De response is correct voor de snapshot, dus de echte vraag is wat die snapshot bevat.

Drie situaties verklaren de meeste van deze gevallen.

Een recent gelanceerd domein

Een recent gelanceerde site kan DR 0 tonen omdat de snapshot ouder is dan de links. Zero betekent hier geen verwijzend domein gevonden, geen oordeel over de site.

Wacht op een latere vernieuwing voordat je de waarde leest als een oordeel over de site.

Vergelijk de leeftijd van het domein met de vernieuwingscyclus voordat je handelt. Een nieuwe naam en een oude naam die nooit links heeft aangetrokken, zien er in dezelfde snapshot hetzelfde uit.

Een link die deze maand is toegevoegd

Links die na de laatste vernieuwing zijn toegevoegd, ontbreken in de waarde. Een herhaalde call retourneert hetzelfde antwoord tot de volgende vernieuwing komt.

Noteer de datum van de link en de datum van de snapshot, zodat de kloof makkelijk uit te leggen is voor iedereen die het rapport leest.

Een link die is verdwenen

Een link kan verdwijnen als de pagina wordt verwijderd of de donor-site sluit. Het aantal daalt dan, hoewel er aan je kant niets is veranderd.

Vergelijk twee snapshots met een paar maanden ertussen voordat je het endpoint de schuld geeft.

Tel hoeveel domeinen bewegen, niet alleen het totaal. Een klein verlies verspreid over veel sites leest anders dan een groot verlies van één site.

Waar niet automatisch opnieuw proberen

Lussen op een 402 verbrandt tijd en levert niets op. Lussen op een 401 kan abuse-detectie triggeren bij elke provider, die van ons of Google.

Reserveer retries voor netwerkfouten, en geef elke retry een langere pauze dan de vorige. Drie pogingen is een verstandige plafond voor een nightly job.

Stel dat een nightly job een 402 ontmoet om twee uur 's nachts. Elke vijf minuten opnieuw proberen tot het ontbijt levert ongeveer honderd identieke fouten op, en elke is een logregel die iemand later moet lezen.

Gebruik een vast plafond voor netwerk-retries ook, en log elke poging. Een plafond dat je in één zin kunt noemen, is makkelijk te verdedigen als een job stopt.

Meldingen voor een job die onbemand draait

Een nightly check domain score job moet iemand vertellen wanneer het stopt, en het moet zeggen waarom. De twee codes hebben verschillende meldingen nodig, dus houd ze gescheiden in het bericht.

Meld de eerste 401

Een enkele 401 betekent meestal een sleutelprobleem, dus een enkele fout is een bericht waard. Wachten op honderd identieke fouten vertraagt de fix alleen.

Voeg de eerste en laatste tekens van de sleutel toe aan de melding, niet de hele sleutel, zodat het bericht veilig is om te delen met een collega.

Een 402 verdient een eigen bericht, omdat de oplossing een top-up is in plaats van een wissel van sleutel.

Eine stille job is niet per se een gezonde job. Tel de runs die zijn voltooid, niet alleen de runs die zijn mislukt, en meld wanneer geen van beide cijfers beweegt voor een volledige cyclus.

Meld een dalend saldo

Stel de waarschuwing in op een niveau dat de rest van de run dekt, niet op nul. Een saldo dat bijna leeg is wanneer de job start, laat geen ruimte voor retries.

Lees het niveau uit _credits op elke geauthenticeerde response, zodat de waarschuwing geen extra request nodig heeft.