Hoppa till innehållet
POLARISAI ACADEMY
Fördjupning, frivillig

Den här lektionen är en frivillig fördjupning till kursen F02. Den innehåller räkneexempel och fackord. Börja med F02 om du är ny. Till kursen F02 →

FD02 · Första ljuset

Ordlistan i praktiken (300 begrepp)

Efteråt kan du ta en kort fellogg, sätta rätt begrepp på den och välja första åtgärden innan du ändrar någon kod. Du använder Polaris ordlista på /ordlistan som en mekaniker använder en reservdelslista.

Nivå
Första ljuset
Tid
12 h (uppskattning)
Förkunskap
F02
Kurs 2 av 7
Hoppa till

Efter kursen kan du

Eleven kan para ihop 100 felloggar, arkitekturbilder och incidentutdrag med rätt term och rätt åtgärd i /ordlistan.

Läs raden, sedan listan

En loggrad är en kort mening från en maskin. Den anger en status, en tid och ett antal. Du gör om meningen till ett begrepp du kan slå upp, och sedan till en första åtgärd. Polaris ordlista på /ordlistan ger namnet, vad du brukar se, och första steget. Gissar du på de engelska orden hamnar du på fel lager. En rad om too many requests kan vara en gräns som är satt med flit. Timeout kan betyda att du slutade vänta medan andra sidan jobbade vidare.

Jobba i fast ordning. Kopiera de tydliga orden ur loggen, statuskoden eller ordet timeout. Sök i /ordlistan på de orden. Läs posten tills du kan säga vad som fallerade, vem som satte gränsen eller väntan, och vad du gör innan du rör konfigurationen. Kolla sedan grannarna. En 429 hör ihop med hur du försöker igen, och en timeout hör ihop med om jobbet redan hunnit ske. Skriv begreppet och första åtgärden i kanten på incidentanteckningen. Den anteckningen jämför du nästa gång samma form dyker upp.

Vad en post ger dig

Slå upp rate limiting i /ordlistan när du ser HTTP 429 Too Many Requests. Statusen betyder att servern nekade anropet för att klienten gick över en anropsgräns. Första åtgärden är att stoppa skuren och vänta. Om svaret har ett Retry-After-värde väntar du minst så många sekunder innan nästa anrop. I ett exempel med gränsen 60 anrop per minut och en logg som visar 120 är överskridandet 120 minus 60, alltså 60. Det talet kan du kontrollera på papper innan du ändrar något.

En timeout-rad betyder att anroparen gav upp efter en bestämd väntan för att inget svar kom. Första åtgärden är att fråga om servern fortfarande gör jobbet. Skickar du samma anrop igen på en gång kan du lägga en andra körning ovanpå den första. Slå sedan upp retry with backoff. Backoff betyder att varje nytt försök väntar längre än det förra. En exempelföljd är 1 sekund, sedan 2, sedan 4. De väntorna blir 7 sekunder tillsammans, och den summan kan du räkna för hand.

När ett andra försök gör jobbet två gånger

Idempotens hör ihop med timeout och retry. Ett anrop är idempotent när två körningar lämnar samma resultat som en. Att läsa en post är oftast ofarligt att upprepa. Att skapa en betalning, skicka e-post eller lägga in en rad kan köras två gånger om du försöker igen efter en timeout. Leta i /ordlistan efter en idempotensnyckel, en token som klienten sparar med första försöket. Kommer samma nyckel igen lämnar servern det ursprungliga resultatet och startar inget andra jobb.

Sätt de fyra begreppen i ordning på papper när du går igenom en logg. Rate limiting förklarar en 429. Timeout förklarar en väntan som tog slut utan innehåll. Retry with backoff är mellanrummen så att senare försök inte bygger upp 429 igen. Idempotens hindrar att ett upprepat anrop dubblar en sidoeffekt. Första åtgärden följer det tidigaste begreppet i kedjan. Ligger du över gränsen saktar du ner innan du ritar om retries. Tog en skrivning timeout kontrollerar du nyckeln innan du skickar anropet igen.

Skisser, anteckningar och den långa listan

Arkitekturskisser använder samma ord som loggar, fast med rutor och pilar. En pil in i en gateway-ruta med noteringen 60 per minut är rate limiting. En streckad pil som tar slut vid 8 sekunder är en timeout. Du kan namnge begreppet utan en lång felutskrift. Incidentanteckningar är kortare. Användare fick 429 efter att mejlet gick ut, eller kassan hängde och vi klickade betala igen, pekar ändå på en post. Stryk under ledtråden, matcha den i /ordlistan, och skriv första åtgärden bredvid.

På drift- och säkerhetsdelen av /ordlistan ska du känna igen varje begrepp när det dyker upp, från rate limiting bort till postmortem. Igenkänning betyder att du kan säga vilket fel ordet namnger och vad första steget brukar vara. Öppna hela posten när incidenten är din att laga. En postmortem är texten efter avbrottet: vad som gick sönder, hur ni märkte det, och vad ni ändrade. Ser du ordet på ett ärende läser du efter åtgärden som blev kvar och jämför med dagens logg.

Hundra lappar är en bra övningshög: felloggar, små skisser och incidentrader. För varje lapp skriver du två saker. Ordlistans begrepp, kopierat som det står i /ordlistan, och första åtgärden i en mening. Kan du inte peka på posten söker du på orden som faktiskt står på lappen. Efter några kvällar skiljer formerna sig. En 429 med stigande antal är rate limiting. En väntan som tar slut utan innehåll är timeout. Ett andra klick efter den väntan är stället där du kollar idempotens.

Ett exempel

En minut logg, fyra begrepp

Ta den här exempel-loggen. Mellan 12:00:00 och 12:00:59 skickar en worker 120 anrop. Den angivna gränsen är 60 anrop den minuten. Spannen är 60 sekunder, så snittet är 120 delat med 60, alltså 2 anrop i sekunden. Tillåten takt är 60 delat med 60, alltså 1 anrop i sekunden. Överskridandet är 120 minus 60, alltså 60 anrop. Klockan 12:00:20 svarar tjänsten HTTP 429 Too Many Requests och sätter Retry-After till 30. De talen räcker för att namnge posten.

Slå upp rate limiting i /ordlistan. 429:an är servern som nekar jobb för att workern körde dubbelt mot tillåten takt, 2 per sekund mot 1 per sekund. Retry-After 30 betyder att tidigaste nästa anrop är 12:00:20 plus 30 sekunder, alltså 12:00:50. Exempelloggen visar sedan ett nytt försök klockan 12:00:20.2. Glappet är 0,2 sekunder, och 0,2 ligger under 30, så försöket struntar i headern. Första åtgärden är att vänta till 12:00:50 och skicka högst 60 anrop nästa minut.

Klockan 12:01:05 säger loggen att POST /orders fick timeout efter 8000 ms och ingen svarskropp. 8000 delat med 1000 är 8 sekunder. Klienten slutade vänta efter den budgeten. Begreppet är timeout. Första åtgärden: ta reda på om order 441 skapades ändå. Klockan 12:01:06 skickar workern samma order igen, alltså 1 sekund senare. Ett andra skapande kan lägga in en andra rad om första anropet hann fram. Slå upp idempotens och skicka om med samma nyckel som första POST.

Retry with backoff är mellanrummen för försök som fortfarande är tillåtna. Ett exempel efter att du respekterat Retry-After på 30 sekunder är att vänta 1 sekund, sedan 2, sedan 4 inför tre ytterligare försök. Lägg ihop glappen: 1 plus 2 plus 4 är 7 sekunder extra tystnad. Använd schemat först efter 12:00:50. Börjar du 1-sekundersglappet klockan 12:00:20 är du tillbaka i skuren som 429:an just stoppade. Tak på försöken. Tre extra försök betyder fyra försök totalt, det ursprungliga plus tre.

Övning

Para ihop tre rader

Gör det här på papper eller i en textredigerare. Rad 1: HTTP 429 Too Many Requests, Retry-After 10, 200 anrop på 60 sekunder, gräns 100 per minut. Rad 2: POST /pay timeout efter 5000 ms, ingen kropp, klienten försökte igen direkt med en ny idempotensnyckel. Rad 3: försök 1 misslyckades, sov 1s, försök 2 misslyckades, sov 2s, försök 3 misslyckades, sov 4s, sedan stopp. För varje rad, namnge begreppet i /ordlistan och skriv första åtgärden i en mening. Visa uträkningen för rad 1 och rad 3.

När rad 1 stämmer är begreppet rate limiting. Överskridandet är 200 minus 100, alltså 100 anrop. Första åtgärden är att vänta minst Retry-After på 10 sekunder, och sedan hålla sig på eller under 100 anrop nästa minut. Snittet på raden är 200 delat med 60 sekunder. Det är 10/3 anrop i sekunden, lite över 3. Tillåtet är 100 delat med 60, alltså 5/3 i sekunden, ungefär 1,7. Skriv båda takterna bredvid begreppet.

När rad 2 stämmer namnger du timeout och idempotens. 5000 ms delat med 1000 är 5 sekunder, så klienten gav upp efter 5 sekunder utan kropp. Första åtgärden är att ta reda på om betalningen gick igenom, och sedan försöka igen bara med samma idempotensnyckel. När rad 3 stämmer är begreppet retry with backoff. Glappen är 1, 2 och 4 sekunder, och 1 plus 2 plus 4 är 7. Använd en gratis chattbot bara för att jämföra efter att anteckningen är skriven.

Kontrollfrågor

Svara själv först. Öppna sedan frågan för att se svaret.

I det genomräknade exemplet, hur många anrop låg över gränsen den minuten, och vilket begrepp matchar HTTP 429 Too Many Requests?

120 minus 60 är 60 anrop över gränsen. Begreppet är rate limiting. Första åtgärden är att vänta till 12:00:50 och sedan skicka högst 60 anrop nästa minut.

Exemplet försöker igen klockan 12:00:20.2 efter Retry-After 30. Varför är det fel första åtgärd?

12:00:20 plus 30 sekunder är 12:00:50. Glappet är 0,2 sekunder, vilket är under 30, så försöket struntar i headern och håller skuren igång.

POST /orders får timeout efter 8000 ms och skickas igen 12:01:06 med en ny idempotensnyckel. Vad ska du göra i stället?

8000 delat med 1000 är 8 sekunder. Ta reda på om order 441 skapades. Om du skickar om, använd samma idempotensnyckel så att servern inte startar en andra order.

Ett exempel på backoff väntar 1, 2 och 4 sekunder. Vad blir summan, och när får schemat börja om Retry-After är 30 sekunder från 12:00:20?

1 plus 2 plus 4 är 7 sekunder. Börja schemat först efter 12:00:50, eftersom Retry-After är tidigaste tillåtna nästa anrop.

Ta med dig

Kopiera de skarpa orden ur loggen, öppna /ordlistan och skriv begreppet plus en första åtgärd innan du försöker igen. Vid en 429 väntar du ut gränsen, och vid timeout tar du reda på om jobbet redan hänt och behåller samma idempotensnyckel om du måste skicka om.

Slutuppgift

Klara ett nyckelrättat diagnostiskt prov på 50 uppgifter där verkliga felloggar och HTTP-/systemspår kopplas till rätt term i /ordlistan, och bygg ett uppslagsverktyg i JSON (kommandorad eller webb) som klarar 15 fasta automatiska tester.

Slutuppgiften rättas av fasta facit och automatiska tester när proven öppnar.

Prov och diplom kommer

Lektionen är öppen att läsa. Prov, diplom och konto kommer senare; väntelistan är till för dem. Till väntelistan