Skip to main content
Faqja kryesoreBlogUdhëzuesSkadoi kërkesa për gjurmim në kohë reale? Rregullat e riprovimit, kalimit te alternativa dhe statusit që duhen ndjekur

Skadoi kërkesa për gjurmim në kohë reale? Rregullat e riprovimit, kalimit te alternativa dhe statusit që duhen ndjekur

17TRACK

Kur një kërkesë për gjurmim në kohë reale skadon, trajtojeni statusin më të fundit të dërgesës si të panjohur—jo si të vonuar, të humbur ose të pandryshuar. Përsëriteni kërkesën vetëm brenda një buxheti kohor të kufizuar, më pas shfaqni një përditësim të fundit të njohur, të etiketuar qartë, ose kërkojini përdoruesit të kontrollojë përsëri më vonë. Gjatë gjithë procesit, mbajini të ndara rezultatin e kërkesës, freskinë e të dhënave dhe statusin real të pakos.

Real Time Tracking Request Timed Out Retry Fallback and Status

Ky dallim është i rëndësishëm si për faqet e gjurmimit të drejtuara klientëve, ashtu edhe për sistemet që përdorin të dhënat e gjurmimit për të aktivizuar njoftime ose rrjedha pune të mbështetjes. Një skadim ju tregon se një përgjigje nuk mbërriti në kohë. Ai nuk ju tregon nëse transportuesi ka një ngjarje të re, nëse një shërbim i ndërmjetëm e përpunoi kërkesën ose nëse pakoja ka lëvizur.

Së pari, identifikoni se çfarë skadoi

Një kërkesë gjurmimi mund të dështojë në disa pika: shfletuesi mund të ndalojë së prituri aplikacionin tuaj, aplikacioni juaj mund të ndalojë së prituri një tracking API, ose ai API mund të skadojë gjatë kontaktimit me një shërbim tjetër. Përdoruesi mund të shohë të njëjtin gabim të përgjithshëm në secilin rast, por veprimi i duhur i radhës ndryshon.

  • Skadim nga ana e klientit: Aplikacioni ndaloi së prituri. Kërkesa në anën e serverit mund të ketë përfunduar ende. Kontrolloni regjistrat e kërkesave ose depon e rezultateve përpara se të dërgoni një kërkesë tjetër që mund të përsërisë punën.
  • Dështim i rrjetit ose lidhjes: Sistemi juaj nuk mori një përgjigje të përdorshme. Mund të mos dini nëse shërbimi në distancë e përpunoi kërkesën.
  • HTTP 504: Një gateway ose proxy nuk mori në kohë një përgjigje nga një server i ndërmjetëm. Kjo përshkruan rrugën e kërkesës, jo dërgesën.
  • HTTP 408: Serveri nuk mori një mesazh të plotë kërkese brenda kohës që ishte përgatitur të priste. Ky nuk është status gjurmimi i transportuesit.
  • HTTP 200 me një ngjarje të vjetër: Kërkesa pati sukses, por informacioni i kthyer i gjurmimit mund të jetë ende i vjetëruar. Një përgjigje e suksesshme HTTP nuk garanton freskinë.

Regjistrojini këto rezultate si diagnostikime të kërkesës. Mos i përktheni asnjërin prej tyre në etiketa dërgese si “në transport”, “përjashtim” ose “dorëzuar”. Këto etiketa duhet të vijnë nga ngjarjet e gjurmimit ose nga një fushë statusi e dokumentuar, jo nga shtresa e transportit.

Përdorni një përsëritje të kufizuar, jo një cikël pa fund

Për një kërkim gjurmimi vetëm për lexim, një përsëritje pas skadimit është shpesh e arsyeshme. Megjithatë, ajo duhet të jetë e kufizuar. Kërkesat e përsëritura mund të rrisin ngarkesën mbi një shërbim në vështirësi, të zgjasin pritjen e përdoruesit dhe të krijojnë punë të dyfishtë kur disa shtresa të aplikacionit përsërisin kërkesën në mënyrë të pavarur.

  1. Vendosni një afat të përgjithshëm. Përcaktoni sa gjatë mund të zgjasë operacioni i drejtuar përdoruesit, duke përfshirë përpjekjen fillestare dhe çdo përsëritje. Mos i jepni çdo përpjekjeje një afat të ri të plotë që tejkalon kohën gjatë së cilës thirrësi mund të presë.
  2. Kontrolloni nëse operacioni është i sigurt për t’u përsëritur. Një kërkim zakonisht ndryshon nga një kërkesë që regjistron një dërgesë, ndryshon cilësime ose krijon një burim. Mos e ridërgoni automatikisht një kërkesë që ndryshon gjendjen, përveçse kur kontrata e ofruesit ose kontrollet tuaja të idempotencës e bëjnë këtë të sigurt.
  3. Përsëriteni me masë një dështim kalimtar. Përdorni një buxhet të vogël dhe të qartë përsëritjesh dhe një vonesë me jitter, në vend që të dërgoni përsëritje të menjëhershme të njëkohshme nga shumë klientë.
  4. Respektoni udhëzimet e zbatueshme të serverit. Nëse një përgjigje përfshin një kokë të vlefshme Retry-After, mos planifikoni një përsëritje më të hershme. Respektoni gjithashtu çdo kufi më të rreptë të aplikacionit ose të ofruesit.
  5. Ndaloni kur afati ose buxheti shteron. Kaloni te një përgjigje rezervë dhe planifikoni veçmas rakordimin e mëvonshëm nëse rrjedha juaj e punës ka nevojë për të.

Një dizajn praktik mund të lejojë një përsëritje të drejtuar përdoruesit nëse ka mjaftueshëm kohë, ndërsa përpjekjet e mëtejshme t’i kalojë te një rifreskim në sfond. Ky është një shembull politike, jo një rregull universal API. Zgjidhni kufijtë bazuar në objektivat e nivelit të shërbimit, vonesën e vëzhguar dhe dokumentacionin e ofruesit. Numëroni gjithashtu përsëritjet e kryera nga bibliotekat HTTP, gateway-t dhe punonjësit e detyrave; përndryshe, një politikë në dukje modeste e aplikacionit mund të prodhojë shumë thirrje në shërbimet e ndërmjetme.

Për HTTP 429, trajtojeni përgjigjen si sinjal të kufirit të shpejtësisë dhe jo si arsye për të përsëritur menjëherë. HTTP 503 mund të tregojë një paaftësi të përkohshme për të trajtuar kërkesën dhe serveri mund të japë Retry-After. Një 504 mund të jetë kalimtar, por nuk garanton që përpjekja tjetër do të funksionojë. Gabimet e autentikimit zakonisht kërkojnë kontroll të kredencialeve ose lejeve, ndërsa kërkesat e formuara gabim kërkojnë korrigjim të hyrjeve. Një identifikues gjurmimi që jep rezultat “nuk u gjet” kërkon më shumë kujdes: në varësi të sjelljes së dokumentuar të ofruesit dhe fazës së dërgesës, mund të jetë ende herët për të gjetur një regjistrim ose identifikuesi mund të jetë i gabuar. Mos e ktheni një rezultat të tillë në pretendimin përfundimtar se pakoja nuk ekziston.

Zgjidhni një rezervë që ruan atë që dini

Rezerva më e sigurt zakonisht është rezultati i fundit i verifikuar i gjurmimit, i shoqëruar me kohën e vet të ngjarjes dhe një etiketë të sinqertë freskie. Mbajeni këtë rezultat të dalluar nga dështimi i kërkesës aktuale. Një faqe mund të thotë: “Përditësimi më i fundit i disponueshëm: U largua nga objekti. Kontrolluar për herë të fundit: [ora]. Një përditësim më i ri nuk është përkohësisht i disponueshëm.” Përfshini “Kontrolluar për herë të fundit” vetëm nëse sistemi juaj e regjistron realisht; kjo nuk zëvendëson kohën e ngjarjes së transportuesit.

Përdorni kohën më specifike që mund të mbështesni. Koha e një ngjarjeje të transportuesit përshkruan kur raportohet se ka ndodhur ngjarja. Koha kur sistemi juaj e mori atë ngjarje përshkruan marrjen. Koha kur një përdorues hapi faqen nuk përshkruan asnjërën. Nëse burimi nuk jep kohë ose zonë kohore të besueshme të ngjarjes, mos shpikni një të tillë. Po kështu, nëse rezultati i ruajtur nuk ka kohë të regjistruar të marrjes, quajeni “përditësimi i fundit i disponueshëm” në vend që të pretendoni se u rifreskua së fundmi.

Një rezervë duhet të ndjekë tre kufij:

  • Shfaqini të dhënat e ruajtura si të dhëna të ruajtura. Mos e paraqitni një ngjarje më të vjetër si rezultat të kërkesës që skadoi.
  • Mos nxirrni përfundime për përparimin nga koha e kaluar. Një pako nuk është “në shpërndarje” vetëm sepse ka qenë në transport për disa ditë.
  • Mos e fshihni pasigurinë materiale. Nëse nuk ka rezultat të mëparshëm, thoni se gjurmimi nuk është përkohësisht i disponueshëm, në vend që të shfaqni një status të paracaktuar të sajuar.

Rrugë të tjera rezervë mund të përfshijnë një depo gjurmimi të sinkronizuar më parë, një kërkim të autorizuar te transportuesi ose një rifreskim të mëvonshëm në sfond. Përdorini vetëm nëse përputhen me dërgesën, lejet tuaja dhe kushtet e burimit të të dhënave. Një burim i dytë mund të ketë emra të ndryshëm ngjarjesh ose vonesa raportimi, prandaj ruani origjinën dhe shmangni bashkimin e regjistrimeve kontradiktore pa një rregull për ta bërë këtë. Nëse klienti mund të veprojë mbi rezultatin, ofroni një mënyrë për të provuar përsëri ose për të kontaktuar mbështetjen, në vend që të lini një tregues ngarkimi pafundësisht.

Mbajini të ndara statusin e kërkesës, freskinë e të dhënave dhe statusin e dërgesës

Këto janë tre fusha të ndryshme, edhe nëse ndërfaqja e përdoruesit i shfaq së bashku. Statusi i kërkesës tregon nëse kërkimi pati sukses, skadoi ose mori një gabim. Freskia e të dhënave tregon kur u vëzhgua informacioni i kthyer ose i ruajtur. Statusi i dërgesës tregon çfarë raporton burimi i gjurmimit për pakon. Ndarja e tyre parandalon që një dështim i përkohshëm i API-së të mbishkruajë një ngjarje të vlefshme dorëzimi ose ta kthejë një ngjarje të vjetëruar “në transport” në pretendim aktual.

Për shembull, një sistem mund të mbajë një ngjarje të verifikuar “Dorëzuar” nga një kërkim i mëparshëm, ndërsa rifreskimi aktual skadon. Ngjarja e dorëzimit nuk zhduket. Gjendja e saktë e kombinuar është se statusi i fundit i disponueshëm i dërgesës është “dorëzuar” dhe rifreskimi më i fundit dështoi. Në të kundërt, nëse ngjarja e fundit është “Në transport”, një skadim nuk konfirmon se pakoja mbetet në transport në këtë moment; ai konfirmon vetëm se nuk u mor përgjigje më e re.

Zbatoni një rregull të përcaktuar kur ngjarjet mbërrijnë jashtë rendit. Krahasoni identifikuesit e ngjarjeve, vulat kohore, burimin dhe semantikën e dokumentuar të statusit nga ofruesi, kur është e disponueshme. Mos supozoni se rendi në të cilin sistemi juaj mori përditësimet është rendi në të cilin ndodhën ngjarjet e dërgesës. As një ngjarje më e vjetër që mbërrin me vonesë nuk duhet të zëvendësojë automatikisht një status më të ri të verifikuar. Korrigjimet dhe përjashtimet mund të jenë të ligjshme, prandaj shmangni një rregull absolut që i trajton ndryshimet e statusit pas dorëzimit si të pamundura. Ruani ngjarjet bazë dhe hetoni kontradiktat në vend që të rishkruani në heshtje historikun.

Nëse një ofrues kthen HTTP 202, interpretojeni sipas kontratës së atij endpoint-i: pranimi i një kërkese nuk është vetvetiu një kërkim gjurmimi i përfunduar. Në mënyrë të ngjashme, HTTP 200 përcakton se një kërkesë HTTP pati sukses sipas semantikës së atij endpoint-i; nuk provon që çdo fushë gjurmimi është e pranishme ose aktuale. Hartëzoni fushat specifike të përgjigjes së ofruesit vetëm pasi të kontrolloni dokumentacionin e tij.

Bëjeni dështimin të dukshëm për operatorët pa alarmuar klientët

Një regjistrim i dobishëm operacional përfshin ID-në e kërkesës, endpoint-in ose operacionin, numrin e përpjekjeve, kohën e kaluar, shtresën e skadimit, statusin HTTP nëse u mor, dhe nëse përgjigjja erdhi nga një kërkim aktiv ose nga rezerva. Për të dhënat e gjurmimit, regjistroni burimin dhe vulat kohore përkatëse të ngjarjes ose marrjes. Trajtojini numrat e gjurmimit dhe informacionin e klientëve sipas rregullave të organizatës suaj për aksesin dhe ruajtjen; dobia diagnostikuese nuk është arsye për të ekspozuar identifikues të plotë në regjistra të pakufizuar.

Vëzhgoni modelet në vend që të mbështeteni në një skadim të vetëm. Një rritje e shkallës së skadimeve në një rrugë të caktuar transportuesi, përgjigje të përsëritura 429 ose një hendek në rritje midis kohës së ngjarjes së transportuesit dhe kohës së marrjes mund të tregojnë probleme të ndryshme. E para mund të kërkojë hetim të ofruesit, e dyta mund të kërkojë kontroll të ritmit, dhe e treta mund të kërkojë kontroll të sinkronizimit ose dorëzimit të ngjarjeve. Nëse një aplikacion ofron gjurmim përmes një ofruesi si 17TRACK Tracking API, përdorni dokumentacionin e atij ofruesi për të verifikuar fushat specifike të përgjigjes së endpoint-it, kufijtë e kërkesave dhe trajtimin e gabimeve përpara zbatimit të këtyre rregullave të përgjithshme.

Për mesazhin drejtuar klientit, jini të saktë dhe të përmbajtur: “Nuk mund ta rifreskonim gjurmimin tani. Ja përditësimi më i fundit i disponueshëm.” Jepni një hap të radhës kur ndihmon, si kontrollimi përsëri më vonë ose kontaktimi i mbështetjes nëse dërgesa është përtej afatit të pritshëm të dorëzimit të dhënë nga shitësi ose transportuesi. Shmangni premtimin e një kohe rifreskimi që sistemi juaj nuk mund ta garantojë.

Lista e kontrollit për publikimin e një rrjedhe gjurmimi të sigurt ndaj skadimeve

  • Konfirmoni se cila shtresë vendos çdo skadim dhe cila shtresë zotëron përsëritjet.
  • Vendosni një afat të përgjithshëm të kërkesës dhe një buxhet të veçantë, të kufizuar përsëritjesh.
  • Verifikoni që operacionet e përsëritura automatikisht janë të sigurta për t’u përsëritur.
  • Respektoni kufijtë e shpejtësisë dhe udhëzimet e vlefshme Retry-After.
  • Ruajeni rezultatin e kërkesës veçmas nga statusi i dërgesës dhe historiku i ngjarjeve.
  • Etiketoni të dhënat rezervë dhe ruani burimin e tyre dhe vulat kohore kur janë të disponueshme.
  • Testoni skenarët pa cache, me cache të vjetëruar, 429, 503, 504 dhe përgjigje të vonuara.
  • Kontrolloni që një skadim të mos aktivizojë një njoftim të pasaktë dorëzimi ose të fshijë një ngjarje të verifikuar.

Rregulli udhëzues është i thjeshtë: përsëriteni një kërkesë vetëm kur kjo është e sigurt dhe e dobishme; përdorni rezervë vetëm me informacionin që mund të identifikoni; dhe mos bëni kurrë një pretendim për statusin e dërgesës nga një skadim HTTP.

FAQ

A duhet ta përsëris menjëherë një kërkesë gjurmimi që ka skaduar?

Jo automatikisht. Kontrolloni që operacioni të jetë i sigurt për t’u përsëritur, që afati i përgjithshëm të lërë kohë për një përpjekje tjetër dhe që asnjë udhëzim për kufirin e shpejtësisë të mos kërkojë pritje. Një përsëritje e shkurtër, e kufizuar dhe me jitter mund të jetë e përshtatshme për një kërkim vetëm për lexim; përsëritjet e menjëhershme dhe të përsëritura nuk janë zgjedhje e mirë parazgjedhur.

A do të thotë HTTP 504 se sistemi i gjurmimit të transportuesit është jashtë funksionit?

Jo. Do të thotë se një gateway ose proxy nuk mori në kohë një përgjigje nga shërbimi i ndërmjetëm. Problemi mund të jetë kudo përgjatë asaj rruge kërkese. Kjo nuk përcakton disponueshmërinë e përgjithshme të transportuesit ose gjendjen e pakos.

A mund ta shfaq statusin e fundit të njohur pas një skadimi?

Po, nëse e etiketoni si informacionin më të fundit të disponueshëm dhe jo si rifreskim aktiv të suksesshëm. Shfaqni kohën e ngjarjes dhe kohën e marrjes kur dihen dhe bëjeni të qartë se një përditësim më i ri nuk mund të konfirmohej.

A duhet që një skadim ta ndryshojë dërgesën nga “në transport” në “përjashtim”?

Jo. Një skadim është dështim kërkese, jo ngjarje dërgese. Ndryshojeni statusin e dërgesës vetëm kur një burim i besueshëm gjurmimi jep një ngjarje ose status që e mbështet ndryshimin.

Po sikur kërkesa që skadoi të ishte duke krijuar ose regjistruar një regjistrim gjurmimi?

Mos supozoni se dështoi. Sistemi në distancë mund ta ketë përpunuar përpara se përgjigjja të humbiste. Kontrolloni për një rezultat ekzistues dhe përdorni një mekanizëm të dokumentuar idempotence ose një procedurë rikuperimi të miratuar nga ofruesi përpara se ta dërgoni përsëri.

Burimet