Skip to main content
KezdőlapBlogÚtmutatók7 módszer a követési frissítési gyakoriság konfigurálására: frissebb adatok, kevesebb API-kérés

7 módszer a követési frissítési gyakoriság konfigurálására: frissebb adatok, kevesebb API-kérés

17TRACK

A nyomon követési frissítések gyakoriságát frissességi célérték beállításával, a lekérdezés gyakoriságának a küldemény állapotához igazításával, ahol támogatott, webhookok használatával, a kimaradt frissítések egyeztetésével, a megosztott eredmények gyorsítótárazásával, az ütemezett feladatok kötegelésével, valamint hibák vagy sebességkorlátozások esetén fokozatos visszalépéssel konfigurálhatja. A fejlesztők és az üzemeltetési csapatok számára nem a lehető legrövidebb időköz a cél, hanem az, hogy a hasznos küldeményváltozások ismételten változatlan adatok lekérése nélkül eljussanak a rendszereikbe.

7 Ways to Configure Tracking Update Frequency Fresher Data fewer

Ezek a vezérlők általában abban az alkalmazásban találhatók, amely összeköti a nyomonkövetési szolgáltatót a rendeléskezelő rendszerrel, az ügyfélszolgálati platformmal vagy az ügyfelek által használt nyomonkövetési oldallal. Egyes szolgáltatók saját frissítési vezérlőket is kínálnak. Tartsa külön ezt a két réteget: az alkalmazás lekérdezési ütemezésének módosítása nem feltétlenül változtatja meg azt, hogy a szolgáltató milyen gyakran ellenőrzi a fuvarozót.

Először határozza meg, melyik frissítési gyakoriságot szabályozhatja

Egy küldeményfrissítés több szakaszon halad át, mielőtt az ügyfél láthatja. A fuvarozó rögzít egy eseményt, egy nyomonkövetési szolgáltatás lekéri azt, az alkalmazás fogadja vagy lekéri az adatot, a kezelőfelület pedig megjeleníti. Bármely szakasz késedelme elavultnak tüntetheti fel a nyomon követést.

  • Fuvarozói esemény elérhetősége: amikor a fuvarozó rögzít és közzétesz egy szkennelést vagy állapotváltozást.
  • A szolgáltató frissítési gyakorisága: amikor egy nyomonkövetési szolgáltatás ellenőrzi vagy fogadja a fuvarozói információkat.
  • Az alkalmazás lekérési gyakorisága: amikor a rendszer információt kér le vagy feldolgozza a beérkező értesítéseket.
  • A megjelenítés frissítési gyakorisága: amikor a webhely, az alkalmazás vagy az ügyfélszolgálati eszköz frissíti a helyi nézetét.

A szolgáltató gyakoribb lekérdezése csökkentheti a harmadik késedelmet. Nem garantálhat azonban újabb fuvarozói szkennelést, és nem kényszeríthet ki upstream frissítést, kivéve, ha egy dokumentált végpont kifejezetten ezt a műveletet végzi. Ütemezés módosítása előtt állapítsa meg, hogy az API-kérés tárolt nyomonkövetési adatokat olvas-e, frissítést kezdeményez-e, vagy valami mást végez.

A 17TRACK-integrációhoz kezdje a Tracking API áttekintésével és a hivatalos API-dokumentációval. Ellenőrizze a használni kívánt műveletek működését, beleértve a frissítések kézbesítését, a kérési korlátokat és az esetleges frissítési vezérlőket. Az alábbi ütemezési minták alkalmazásoldali ajánlások, nem pedig annak állításai, hogy minden időköz konfigurálható 17TRACK-beállítás.

1. Állítson be frissességi célértéket az időköz kiválasztása előtt

Határozza meg, hogy az egyes üzleti munkafolyamatoknak milyen gyorsan kell értesülniük egy újonnan elérhető eseményről. A kézbesítési kivételeket kezelő várólista szigorúbb célértéket indokolhat, mint egy korábbi küldeményeket megjelenítő irányítópult. Ha mindkettőhöz ugyanazt a lekérdezési időközt használja, az felesleges kéréseket generálhat, vagy az sürgősebb munkafolyamatot szolgálhatja ki elégtelenül.

Válasszon külön két mérőszámot: az utolsó sikeres lekérés óta eltelt időt, valamint a legutóbbi küldeményesemény korát. Egy sikeres kérés régi eseményt is visszaadhat, ha semmi sem változott. Ez eltér attól, amikor egy sikertelen integráció nemrég nem kért le adatokat.

Az időközök kódban való szétszórt beágyazása helyett használjon kis konfigurációs szabályzatot:

  • Frissességi cél: a szolgáltatói elérhetőség és az alkalmazásba való betöltés közötti elfogadható késedelem.
  • Normál lekérdezési időköz: az alapértelmezett időköz a jogosult küldeményekhez.
  • Maximális egyeztetési hézag: mennyi ideig maradhat egy küldemény sikeres ellenőrzés nélkül.
  • Kérési keret: az újrapróbálkozások, az egyeztetés és az egyéb API-műveletek figyelembevétele után rendelkezésre álló kapacitás.

Tervezési példaként 12 000 küldemény óránkénti egyenkénti ellenőrzése újrapróbálkozások előtt napi 288 000 ütemezett lekérési kérést eredményezne. Négyóránkénti ellenőrzés esetén ez 72 000 lenne. Ezek szemléltető számítások, nem szolgáltatói korlátok vagy ajánlott időközök; a kötegelés és a push-alapú kézbesítés módosítaná a számítást.

Válassza a leghosszabb olyan időközt, amely megfelel a munkafolyamat frissességi céljának, majd tesztelje, hogy az upstream adatok elég frissek-e ahhoz, hogy az időköz hasznos legyen.

2. Módosítsa az időközt a küldemény állapotának változásakor

Egyetlen ütemezés figyelmen kívül hagyja a küldemények viselkedését. Egy első szkennelésre váró csomag, egy hosszú szállítási szakaszon haladó küldemény és egy kézbesítéshez közeledő csomag nem feltétlenül igényel azonos figyelmet.

Küldemény állapotaJavasolt ütemezési megközelítésVédőkorlát
Első fuvarozói információra várVégezzen korlátozott számú ellenőrzést, majd változatlanság esetén növelje az időközt.Ne tekintse önmagában a hiányzó szkenneléseket a küldemény sikertelensége bizonyítékának.
Normál mozgásbanHasználja az adott szolgáltatáshoz vagy útvonalhoz tartozó alapidőközt.Tartson fenn maximális egyeztetési hézagot.
Kézbesítéshez közeledikFontolja meg rövidebb időközök használatát, ha az időszerű frissítések valódi műveletet támogatnak.Mérje meg, hogy a további kérések új információt adnak-e.
Kivétel vagy elhúzódó inaktivitásRészesítse előnyben a kivizsgálást, és használjon korlátozott megfigyelési ütemezést.A gyorsabb lekérdezés nem oldja meg a kivétel mögöttes okát.
Kézbesítve vagy egyébként lezárvaA lezárási ellenőrzések után távolítsa el a rutinszerű lekérdezésből.Hagyjon lehetőséget javításokra és indokolt újranyitásra.

A szolgáltatói állapotokat egyértelműen képezze le a belső életciklusra. Ne feltételezze, hogy a visszaküldött küldemény, a sikertelen kézbesítési kísérlet és a sikeres kézbesítés mindegyikének le kell állítania a megfigyelést. Eltérő operatív döntéseket igényelhetnek.

Tároljon minden küldeményhez egy következő jogosult ellenőrzési időpontot, és számítsa újra, amikor jelentős esemény érkezik. Ez ellenőrizhetővé teszi az ütemezést, és elkerüli az olyan időzítő használatát, amely minden rekordot azonosan kezel.

3. Használjon webhookokat a változásokhoz, ha a szolgáltató támogatja őket

A lekérdezés azt kérdezi, hogy történt-e változás. A webhook lehetővé teszi, hogy a szolgáltató értesítse az alkalmazást, amikor frissítés válik elérhetővé. Ha a szükséges események és kézbesítési működés támogatott, használja a push-alapú kézbesítést elsődleges betöltési útvonalként ahelyett, hogy ismételten lekérdezné az összes aktív küldeményt.

A webhookok nem szüntetik meg az upstream késedelmeket. Emellett kézbesítéskezelési követelményeket is bevezetnek. Megvalósítás előtt ellenőrizze a szolgáltató dokumentált hitelesítési mechanizmusát, nyugtázási szabályait, újrapróbálkozási viselkedését és eseményazonosítóit.

  • A beérkező kéréseket a dokumentált mechanizmussal hitelesítse.
  • A sikeres fogadás nyugtázása előtt tartósan tárolja vagy sorba állítsa az érvényes értesítést.
  • Idempotensen dolgozza fel az értesítéseket, hogy az ismételt kézbesítés ne indítson duplikált ügyfélüzeneteket.
  • Kezelje a késleltetett és sorrenden kívüli eseményeket anélkül, hogy régebbi információval felülírná az újabb állapotot.
  • Figyelje a feldolgozási hibákat és a sorban álló értesítések korát.

Ne feltételezze, hogy a webhook-kézbesítés pontosan egyszer történik, vagy mindig időrendi sorrendben érkezik, hacsak a szolgáltató ezt kifejezetten nem garantálja. A küldemény eseménytörténetét tartsa külön az aktuális normalizált állapottól, hogy a későn érkező információ értékelhető legyen, ne pedig vakon kerüljön alkalmazásra.

4. Teljes második lekérdezési ciklus helyett adjon hozzá célzott egyeztetést

A webhookalapú integrációnak is szüksége van helyreállítási útvonalra. A végpont elérhetetlenné válhat, egy worker fogadás után hibázhat, vagy egy belső leképezési hiba megakadályozhatja, hogy a frissítés eljusson a rendelési rekordhoz.

Az egyeztetés azt ellenőrzi, hogy a tárolt állapot megegyezik-e a szolgáltató állapotával. Azokra a rekordokra kell összpontosítania, amelyek ellenőrzést igényelnek, nem pedig a teljes küldeményállomány gyakori lekérdezését kell újra létrehoznia.

Hasznos egyeztetési jelöltek a sikertelen értesítésfeldolgozású küldemények, a maximális ellenőrzési hézagot meghaladó rekordok és egy ismert kiesés által érintett küldemények. Egy régi fuvarozói esemény önmagában nem feltétlenül bizonyítja a kimaradt frissítést.

Kiesés után állítsa sorba az érintett rekordokat, majd szabályozott kérési kereten belül dolgozza fel őket. Szüntesse meg az átfedő helyreállítási feladatok duplikációját, és törölje a redundáns munkát, ha egy sikeres frissítés már megoldotta az eltérést. Kerülje az egyidejű kérés indítását minden aktív küldeményhez.

A legutóbb sikeresen ellenőrzött időpontot külön kövesse a legutóbbi esemény időpontjától. Ellenkező esetben egy friss szkenneléssel nem rendelkező csomag ismételten egyeztetésre jogosulttá válhat, noha a rendszer éppen megerősítette, hogy a szolgáltatónál nincs új információ.

5. Gyorsítótárazza a nyomonkövetési adatokat, és ossza meg a kéréseket a fogyasztók között

Egy nyomonkövetési oldal, egy ügyfélszolgálati irányítópult, egy értesítési worker és a rendelési rendszer mind ugyanazt a küldeményt kérheti le. Adjon nekik közös alkalmazásrekordot ahelyett, hogy minden fogyasztó önállóan kérdezné le a nyomonkövetési szolgáltatót.

Tárolja helyben a legutóbb ismert küldeményállapotot a lekérés időpontjával és a releváns eseményidőpontokkal együtt. Az ütemező vagy a webhookkezelő frissítse ezt a rekordot. Egy ügyféloldali frissítés ne kényszerítsen automatikusan újabb upstream kérést.

A gyorsítótárazás mellett használjon kérés-összevonást is: ha több fogyasztó egyszerre kéri ugyanazt az elavult rekordot, engedjen egyetlen frissítési műveletet, a többiek pedig használják annak eredményét vagy várják meg azt. A gyorsítótárkulcsokat és a hozzáférés-ellenőrzéseket megfelelően határozza meg, hogy az adatok ne kerülhessenek át más fiókok határain.

Ha egy végpont támogat HTTP-validátorokat, például az ETag vagy a Last-Modified értéket, a feltételes kérések csökkenthetik a válas törzsének átvitelét. A feltételes kérés azonban továbbra is kérés, és beleszámíthat a szolgáltató kvótájába. A HTTP-gyorsítótárazás szemantikáját az RFC 9111 határozza meg; az adott nyomonkövetési végpont támogatását külön kell ellenőrizni.

Tegye érthetővé a frissességet a kezelőfelületen. A „Legutóbb ellenőrizve” a lekérést írja le, míg a „Legutóbbi küldeményesemény” a fuvarozói eseményt. Ha egyetlen időbélyeget úgy jelenít meg, mintha mindkettőt képviselné, félrevezetheti az ügyfeleket.

6. Kötegelje a jogosult lekéréseket, és ossza el a kéréseket időben

Ha a releváns lekérési végpont több nyomonkövetési rekordot támogat kérésenként, a kötegelés csökkentheti a HTTP-kérések számát. Ellenőrizze, hogy a szükséges művelet támogatja-e a kötegelést: a kötegelt regisztráció nem jelenti automatikusan a kötegelt lekérést.

Különítse el a szállítási hatékonyságot a számlázástól is. Egy több rekordot tartalmazó HTTP-kérés a szolgáltató szabályaitól függően továbbra is több kvótaegységet vagy számlázható lekérést fogyaszthat.

Egy praktikus ütemezőnek a következőket kell tennie:

  1. Válassza ki azokat a rekordokat, amelyek következő jogosult ellenőrzési ideje elérkezett.
  2. Zárja ki a lezárt, szüneteltetett vagy már sorba állított rekordokat.
  3. Csoportosítsa a jogosult rekordokat a dokumentált végpont- és hasznosadat-korlátokon belül.
  4. Közös sebességkorlátozón keresztül indítsa el a munkát.
  5. Rögzítse minden elem eredményét, és ahol indokolt, csak a sikertelen vagy megoldatlan elemeket próbálja újra.

Ossza el a munkát az ütemezési ablakban ahelyett, hogy minden feladatot egész órakor futtatna. Adjon hozzá korlátozott véletlen eltolást, úgynevezett jittert, a szinkronizált kiugrások csökkentésére. Az eltolás legyen elég kicsi ahhoz, hogy megfeleljen az egyes munkafolyamatok frissességi céljának.

A kötegelés kevésbé hasznos, ha a köteg feltöltésére való várakozás késleltetne egy sürgős frissítést. Engedje, hogy az időérzékeny munka teljes köteg nélkül is elinduljon, miközben ugyanazon általános sebességkereten belül marad.

7. Alkalmazkodjon a sebességkorlátozásokhoz, hibákhoz és alacsony értékű ellenőrzésekhez

A normál frissítési időköz ne legyen egyben a hibák újrapróbálkozási időköze is. Egy elérhetetlen végpontnak szabályozott újrapróbálkozásokra van szüksége, nem pedig a hibákra ráépülő újabb teljes ütemezett kérési hullámra.

A HTTP 429 jelentése „Too Many Requests”, és a válasz tartalmazhat Retry-After mezőt, az RFC 6585 leírása szerint. A mező HTTP-szemantikáját az RFC 9110 határozza meg. Kövesse a vonatkozó szolgáltatói utasításokat és a megadott érvényes Retry-After értéket. Ellenkező esetben korlátozott, exponenciális visszalépést használjon jitterrel az újrapróbálható hibákhoz.

Ne próbálja végtelenül újra a hitelesítési hibákat vagy az érvénytelen nyomonkövetési bemeneteket. Irányítsa ezeket javításra. Szerveroldali állapotot módosító műveleteknél ellenőrizze az újrapróbálkozás biztonságosságát, mielőtt bizonytalan időtúllépés után automatikusan megismételne egy kérést.

A normál lekérdezést külön igazítsa. Ha az ismételt sikeres ellenőrzések nem adnak új információt, fontolja meg az időköz növelését a küldemény frissességi korlátain belül. Amikor egy jelentős esemény időérzékenyebb szakaszba helyezi a csomagot, csökkentse ismét az időközt.

A releváns kvótát megosztó összes workerre alkalmazzon sebességkorlátozást. Az egymástól független worker-korlátok külön-külön megfelelőnek tűnhetnek, miközben együttes forgalmuk meghaladja a fiókszintű engedélyt.

A frissességet és a hatékonyságot együtt ellenőrizze

Tesztelje a szabályzatot a küldemények ellenőrzött csoportján, mielőtt széles körben alkalmazná. Hasonló fuvarozói, útvonal- és életciklus-jellemzőkkel rendelkező munkafolyamatokat hasonlítson össze, hogy a küldeményösszetétel változása ne tűnjön ütemezési javulásnak.

  • Hasznos frissítések aránya: az érdemi információt hozzáadó sikeres ellenőrzések aránya.
  • Ellenőrzési kor: az utolsó sikeres szolgáltatóiállapot-ellenőrzés óta eltelt idő.
  • Betöltési késedelem: a szolgáltatói elérhetőségtől az alkalmazás általi fogadásig eltelt idő, ha az elérhetőség időpontja megfigyelhető.
  • Kérési terhelés: a kérések mennyisége, a sebességkorlátozási válaszok, az újrapróbálkozások és a sormélység.
  • Helyreállítás minősége: az egyeztetéssel helyreállított kimaradt változások és a hibák felszámolásához szükséges idő.

Ne nevezze a fuvarozói eseménytől a betöltésig tartó időt tisztán integrációs késedelemnek. Tartalmazhat olyan upstream közzétételi és begyűjtési késedelmeket, amelyeket az alkalmazás közvetlenül nem szabályozhat. A sikeres szabályzat csökkenti a szükségtelen lekéréseket, miközben az operatív szempontból fontos változásokat a meghatározott frissességi célokon belül tartja.

GYIK

Mi a legjobb lekérdezési időköz a küldemények nyomon követéséhez?

Nincs univerzális időköz. A választást a munkafolyamat frissességi célja, az upstream frissítési viselkedés, az API-korlátok és a kérési keret alapján határozza meg. Kezdjen dokumentált alapértékkel, mérje a sikeres ellenőrzések értékét, és az összes küldemény gyorsítása helyett az életciklus állapota szerint módosítson.

A nyomonkövetési oldal frissítése új fuvarozói ellenőrzést kényszerít ki?

Nem feltétlenül. Az oldal olvashat az alkalmazás gyorsítótárából vagy a szolgáltató tárolt nyomonkövetési adataiból. A böngésző frissítése, az API-lekérés és az upstream fuvarozói frissítés különálló műveletek. Csak akkor írja le a frissítést élőként, ha ezt a dokumentált működés alátámasztja.

A webhookok teljesen kiválthatják a lekérdezést?

A szükséges frissítések szolgáltatói támogatása esetén a rutinszerű lekérdezések nagy részét kiválthatják. Hibák és bizonytalan állapot esetére tartson fenn korlátozott egyeztetési folyamatot. A szükséges további ellenőrzés mértéke a kézbesítési garanciáktól, a helyreállítási lehetőségektől és a kimaradt frissítés következményeitől függ.

Mikor kell leállítani a nyomonkövetési kéréseket a kézbesítés után?

A lezárási ellenőrzések befejezése után távolítsa el a kézbesített küldeményeket a rutinszerű aktív lekérdezésből. Döntse el, hogy a munkafolyamat és a szolgáltató működése alapján indokolt-e korlátozott ellenőrzési időszak. Őrizze meg a javítások feldolgozásának lehetőségét anélkül, hogy minden lezárt küldeményt határozatlan ideig ütemezetten tartana.

A kevesebb HTTP-kérés mindig csökkenti az API-díjakat?

Nem. A számlázás függhet a küldeményektől, a nyomonkövetési rekordoktól, a műveletektől vagy más szerződéses egységtől, nem pedig a HTTP-kérések számától. A kötegeléshez, gyorsítótárazáshoz vagy webhookok használatához kapcsolt pénzügyi megtakarítások meghatározása előtt ellenőrizze az alkalmazandó mérési szabályokat.

Források