Нақты уақыттағы бақылау сұрауының уақыты өтіп кетті ме? Қайталап көру, резервтік нұсқа және күй ережелері
Нақты уақыттағы бақылау сұрауының уақыты аяқталғанда, жөнелтілімнің соңғы күйін белгісіз деп есептеңіз — оны кешіктірілді, жоғалды немесе өзгермеді деп санамаңыз. Қайталап сұрауды тек белгіленген уақыт шегінде орындаңыз, содан кейін соңғы белгілі жаңартуды нақты белгімен көрсетіңіз немесе пайдаланушыдан кейінірек қайта тексеруді сұраңыз. Бүкіл процесс барысында сұрау нәтижесін, деректердің жаңалығын және сәлемдеменің нақты күйін бір-бірінен бөлек ұстаңыз.
Бұл айырмашылық клиенттерге арналған бақылау беттері үшін де, бақылау деректерін хабарландыруларды немесе қолдау көрсету процестерін іске қосу үшін пайдаланатын жүйелер үшін де маңызды. Тайм-аут жауаптың уақытында келмегенін білдіреді. Ол тасымалдаушыда жаңа оқиғаның бар-жоғын, жоғары деңгейдегі қызметтің сұрауды өңдеген-өңдемегенін немесе сәлемдеменің қозғалған-қозғалмағанын көрсетпейді.
Алдымен, қай нәрсенің уақыты аяқталғанын анықтаңыз
Бақылау сұрауы бірнеше кезеңде сәтсіз аяқталуы мүмкін: браузер қолданбаңыздан жауап күтуді тоқтатуы мүмкін, қолданбаңыз бақылау API-інен жауап күтуді тоқтатуы мүмкін немесе басқа қызметпен байланысу кезінде API-дің өзінің уақыты аяқталуы мүмкін. Пайдаланушы әр жағдайда бірдей жалпы қате туралы хабарды көруі мүмкін, бірақ келесі дұрыс әрекет әртүрлі болады.
- Клиент жағындағы тайм-аут: Қолданба күтуді тоқтатты. Сервер жағындағы сұрау әлі де аяқталған болуы мүмкін. Қайталанатын жұмысты тудыруы ықтимал жаңа сұрауды жібермес бұрын, өз сұрау журналдарыңызды немесе нәтижелер қоймасын тексеріңіз.
- Желі немесе байланыс қатесі: Жүйеңіз пайдалануға жарамды жауап алмады. Қашықтағы қызметтің сұрауды өңдеген-өңдемегенін білмеуіңіз мүмкін.
- HTTP 504: Шлюз немесе прокси жоғары деңгейдегі серверден уақытында жауап алмады. Бұл жөнелтілімді емес, сұрау жолын сипаттайды.
- HTTP 408: Сервер күтуге дайын болған уақыт ішінде толық сұрау хабарын алмады. Бұл тасымалдаушының бақылау күйі емес.
- Ескі оқиғасы бар HTTP 200: Сұрау сәтті орындалды, бірақ қайтарылған бақылау ақпараты әлі де ескірген болуы мүмкін. HTTP жауабының сәтті болуы деректердің жаңалығына кепілдік бермейді.
Бұл нәтижелерді сұрау диагностикасы ретінде тіркеңіз. Олардың ешқайсысын «тасымалдау үстінде», «ерекше жағдай» немесе «жеткізілді» сияқты жөнелтілім белгілеріне айналдырмаңыз. Мұндай белгілер тасымалдау деңгейінен емес, бақылау оқиғаларынан немесе құжатталған күй өрісінен алынуы керек.
Шексіз цикл емес, шектеулі қайталап сұрауды пайдаланыңыз
Тек оқуға арналған бақылау іздеуі үшін тайм-ауттан кейін қайталап сұрау жиі орынды болады. Дегенмен оның шегі болуы тиіс. Қайталанатын сұраулар қиындыққа тап болған қызметке түсетін жүктемені арттырып, пайдаланушының күту уақытын ұзартып, бірнеше қолданба қабаты бір-біріне тәуелсіз қайталаған кезде қайталанатын жұмыс тудыруы мүмкін.
- Жалпы соңғы мерзімді белгілеңіз. Бастапқы әрекет пен кез келген қайталап сұрауды қоса алғанда, пайдаланушыға көрсетілетін операция қанша уақытқа созылуы мүмкін екенін анықтаңыз. Әр әрекетке қоңырау шалушы күте алатын уақыттан асып кететін жаңа толық мерзім бермеңіз.
- Операцияны қайталау қауіпсіз екенін тексеріңіз. Әдеттегі іздеу жөнелтілімді тіркейтін, параметрлерді өзгертетін немесе ресурс жасайтын сұраудан өзгеше. Провайдердің келісімі немесе идемпотенттілікті басқару тетіктері қауіпсіздікке кепілдік бермесе, күйді өзгертетін сұрауды автоматты түрде қайталамаңыз.
- Уақытша қатені үнемді түрде қайталаңыз. Шағын әрі нақты қайталау бюджетін және көптеген клиенттен бір мезетте жедел қайталаулар жіберудің орнына, кездейсоқ ауытқуы бар кідірісті пайдаланыңыз.
- Қолданылатын сервер нұсқауларын орындаңыз. Егер жауапта жарамды
Retry-Afterтақырыбы болса, одан ертерек қайталауды жоспарламаңыз. Сондай-ақ қолданбаға немесе провайдерге тән қатаңырақ шектеулерді сақтаңыз. - Соңғы мерзім немесе бюджет біткенде тоқтаңыз. Қосалқы жауапқа ауысыңыз және жұмыс процесіңізге қажет болса, кейінгі сәйкестендіруді бөлек жоспарлаңыз.
Практикалық жобада уақыт жеткілікті болса, пайдаланушыға бір рет қайталап сұрауға мүмкіндік беріп, кейінгі әрекеттерді фондық жаңартуға ауыстыруға болады. Бұл саясаттың мысалы ғана, әмбебап API ережесі емес. Шектеулерді қызмет деңгейі мақсаттарына, байқалған кідірістерге және провайдердің құжаттамасына сүйеніп таңдаңыз. HTTP кітапханалары, шлюздер және тапсырма орындаушылары жасаған қайталауларды да есептеңіз; әйтпесе қарапайым болып көрінетін қолданба саясаты жоғары деңгейге көптеген қоңырау жіберуі мүмкін.
HTTP 429 жағдайында жауапты дереу қайталаудың себебі емес, жылдамдық шектеуінің сигналы ретінде қарастырыңыз. HTTP 503 сұрауды өңдей алмаудың уақытша жағдайын көрсетуі мүмкін және сервер Retry-After тақырыбын ұсынуы ықтимал. 504 уақытша болуы мүмкін, бірақ келесі әрекеттің міндетті түрде сәтті болатынына кепілдік бермейді. Аутентификация қателері әдетте тіркелгі деректерін немесе рұқсаттарды тексеруді, ал қате пішімделген сұраулар енгізілген деректерді түзетуді талап етеді. «Табылмады» нәтижесін беретін бақылау идентификаторына мұқият қарау керек: провайдердің құжатталған әрекетіне және жөнелтілім кезеңіне байланысты жазбаны табуға әлі ерте болуы немесе идентификатор қате болуы мүмкін. Бір ғана осындай нәтижеге сүйеніп, сәлемдеме жоқ деп нақты тұжырым жасамаңыз.
Білетініңізді сақтайтын қосалқы жауапты таңдаңыз
Ең қауіпсіз қосалқы жауап әдетте соңғы тексерілген бақылау нәтижесі болып табылады; оған оқиғаның өз уақыты және деректердің жаңалығы туралы шынайы белгі қоса беріледі. Бұл нәтижені ағымдағы сұраудың сәтсіздігінен бөлек ұстаңыз. Бетте: «Соңғы қолжетімді жаңарту: Нысаннан жөнелтілді. Соңғы тексеру: [уақыт]. Жаңарақ жаңарту уақытша қолжетімсіз» деп көрсетуге болады. «Соңғы тексеру» уақытын жүйеңіз нақты тіркеген жағдайда ғана қосыңыз; ол тасымалдаушы оқиғасының уақытын алмастырмайды.
Растай алатын ең нақты уақытты пайдаланыңыз. Тасымалдаушы оқиғасының уақыты оқиғаның болжам бойынша қашан болғанын сипаттайды. Жүйеңіздің сол оқиғаны алған уақыты деректердің қабылдануын сипаттайды. Пайдаланушының бетті ашқан уақыты бұл екеуін де сипаттамайды. Дереккөз сенімді оқиға уақытын немесе уақыт белдеуін ұсынбаса, оны ойдан шығармаңыз. Сол сияқты кэштелген нәтиженің алыну уақыты тіркелмесе, оны жақында жаңартылды деп мәлімдеудің орнына «соңғы қолжетімді жаңарту» деп атаңыз.
Қосалқы жауап үш шектеуді сақтауы керек:
- Кэштелген деректерді кэштелген дерек ретінде көрсетіңіз. Ескі оқиғаны уақыты аяқталған сұраудың нәтижесі ретінде ұсынбаңыз.
- Өткен уақытқа қарап ілгерілеуді болжамаңыз. Сәлемдеме бірнеше күн бойы тасымалдауда болғаны үшін ғана «жеткізуге шықты» деп саналмайды.
- Маңызды белгісіздікті жасырмаңыз. Бұрынғы нәтиже болмаса, ойдан шығарылған әдепкі күйді көрсетудің орнына бақылау уақытша қолжетімсіз екенін айтыңыз.
Басқа қосалқы жолдарға бұрын синхрондалған бақылау қоймасы, рұқсат етілген тасымалдаушы іздеуі немесе кейінгі фондық жаңарту кіруі мүмкін. Оларды жөнелтілімге, рұқсаттарыңызға және дереккөз шарттарына сәйкес келген жағдайда ғана пайдаланыңыз. Екінші дереккөзде оқиға атаулары немесе есеп беру кідірістері өзгеше болуы мүмкін, сондықтан дереккөзін сақтап, қайшылықты жазбаларды оларды біріктіру ережесінсіз қоспаңыз. Егер клиент нәтижеге сүйеніп әрекет ете алса, шексіз айналатын жүктеу белгісін қалдырмай, қайта көру немесе қолдау қызметіне хабарласу мүмкіндігін беріңіз.
Сұрау күйін, деректердің жаңалығын және жөнелтілім күйін бөлек ұстаңыз
Бұл үш түрлі өріс, тіпті пайдаланушы интерфейсі оларды бірге көрсетсе де. Сұрау күйі іздеудің сәтті болғанын, уақыты аяқталғанын немесе қате алғанын көрсетеді. Деректердің жаңалығы қайтарылған немесе сақталған ақпараттың қашан байқалғанын көрсетеді. Жөнелтілім күйі бақылау дереккөзінің сәлемдеме туралы не хабарлағанын көрсетеді. Оларды бөлу уақытша API қатесінің жарамды жеткізу оқиғасын өшіруіне немесе ескірген «тасымалдау үстінде» оқиғасын ағымдағы мәлімдемеге айналдыруына жол бермейді.
Мысалы, жүйе алдыңғы іздеуден алынған расталған «Жеткізілді» оқиғасын сақтап тұруы мүмкін, ал ағымдағы жаңарту тайм-аутқа ұшырайды. Жеткізу оқиғасы жоғалмайды. Дұрыс біріктірілген күй: соңғы қолжетімді жөнелтілім күйі — жеткізілді, ал ең соңғы жаңарту сәтсіз аяқталды. Керісінше, соңғы оқиға «Тасымалдау үстінде» болса, тайм-аут сәлемдеменің дәл қазір де тасымалдауда екенін растамайды; ол тек жаңарақ жауап алынбағанын растайды.
Оқиғалар ретсіз келген кезде анықталған ережені қолданыңыз. Қолжетімді болса, оқиға идентификаторларын, уақыт белгілерін, дереккөзді және провайдердің құжатталған күй мағыналарын салыстырыңыз. Жүйеңіздің жаңартуларды қабылдау реті жөнелтілім оқиғаларының болу ретімен бірдей деп ойламаңыз. Кеш келген ескі оқиға жаңарақ расталған күйді автоматты түрде алмастырмауы керек. Дегенмен түзетулер мен ерекше жағдайлар заңды болуы мүмкін, сондықтан жеткізілгеннен кейінгі күй өзгерістерін мүмкін емес деп санайтын жаппай ережеден аулақ болыңыз. Бастапқы оқиғаларды сақтап, қайшылықтарды тарихты үнсіз қайта жазбай зерттеңіз.
Провайдер HTTP 202 қайтарса, оны сол соңғы нүктенің келісіміне сәйкес түсіндіріңіз: сұраудың қабылдануы өздігінен бақылау іздеуінің аяқталғанын білдірмейді. Сол сияқты HTTP 200 осы соңғы нүктенің мағынасы бойынша HTTP сұрауының сәтті орындалғанын көрсетеді; ол барлық бақылау өрістерінің бар немесе ағымдағы екенін дәлелдемейді. Провайдерге тән жауап өрістерін тек провайдердің құжаттамасын тексергеннен кейін ғана сәйкестендіріңіз.
Сәтсіздікті операторларға көрінетін етіңіз, бірақ клиенттерді алаңдатпаңыз
Пайдалы операциялық жазбада сұрау идентификаторы, соңғы нүкте немесе операция, әрекеттер саны, өткен уақыт, тайм-аут қабаты, алынған болса HTTP күйі және жауаптың нақты іздеуден немесе қосалқы жауаптан келгені көрсетіледі. Бақылау деректері үшін дереккөзді және тиісті оқиға немесе алыну уақыт белгілерін тіркеңіз. Бақылау нөмірлері мен клиент ақпаратын ұйымыңыздың қолжетімділік және сақтау ережелеріне сәйкес өңдеңіз; диагностиканың пайдалығы толық идентификаторларды шектеусіз журналдарға жазуға себеп емес.
Бір ғана тайм-аутқа емес, үрдістерге назар аударыңыз. Бір тасымалдаушы бағыты бойынша тайм-ауттардың өсуі, қайталанатын 429 жауаптары немесе тасымалдаушы оқиғасының уақыты мен алыну уақыты арасындағы алшақтықтың ұлғаюы әртүрлі мәселелерді көрсетуі мүмкін. Біріншісі провайдерді зерттеуді, екіншісі жылдамдықты басқаруды, үшіншісі синхрондауды немесе оқиғаларды жеткізуді тексеруді талап етуі мүмкін. Егер қолданба бақылауды 17TRACK Tracking API сияқты провайдер арқылы ұсынса, осы жалпы ережелерді енгізбес бұрын соңғы нүктеге тән жауап өрістерін, сұрау шектеулерін және қателерді өңдеуді тексеру үшін сол провайдердің құжаттамасын пайдаланыңыз.
Клиентке көрсетілетін хабарлама нақты әрі ұстамды болсын: «Қазір бақылауды жаңарта алмадық. Міне, соңғы қолжетімді жаңарту». Қажет болса, кейінірек қайта тексеру немесе жөнелтілім сатушы не тасымалдаушы ұсынған күтілетін жеткізу мерзімінен асып кетсе, қолдау қызметіне хабарласу сияқты келесі қадамды көрсетіңіз. Жүйеңіз кепілдік бере алмайтын жаңарту уақытын уәде етпеңіз.
Тайм-аутқа төзімді бақылау процесін шығару тексерімі
- Әр тайм-аутты қай қабат енгізетінін және қай қабат қайталауларға жауапты екенін растаңыз.
- Жалпы сұрау мерзімін және бөлек, шектеулі қайталау бюджетін белгілеңіз.
- Автоматты түрде қайталанатын операцияларды қайта орындау қауіпсіз екенін тексеріңіз.
- Жылдамдық шектеулерін және жарамды
Retry-Afterнұсқауларын сақтаңыз. - Сұрау нәтижесін жөнелтілім күйі мен оқиғалар тарихынан бөлек сақтаңыз.
- Қосалқы деректерді белгілеңіз және қолжетімді болғанда оның дереккөзі мен уақыт белгілерін сақтаңыз.
- Кэшсіз, ескірген кэш, 429, 503, 504 және кеш келген жауап сценарийлерін сынаңыз.
- Тайм-аут қате жеткізу хабарландыруын іске қоса алмайтынын немесе расталған оқиғаны өшіре алмайтынын тексеріңіз.
Негізгі ереже қарапайым: сұрауды тек қауіпсіз әрі пайдалы болғанда қайталаңыз; тек анықтай алатын ақпаратқа ғана қосалқы жауап беріңіз; HTTP тайм-аутынан ешқашан жөнелтілім күйі туралы мәлімдеме жасамаңыз.
Жиі қойылатын сұрақтар
Уақыты аяқталған бақылау сұрауын бірден қайталауым керек пе?
Автоматты түрде емес. Операцияны қайталау қауіпсіз екенін, жалпы мерзімнің тағы бір әрекетке уақыт қалдыратынын және жылдамдық шектеуі туралы нұсқау күту керегін көрсетпейтінін тексеріңіз. Тек оқуға арналған іздеу үшін кездейсоқ ауытқуы бар қысқа, шектеулі қайталау орынды болуы мүмкін; бірден қайталанатын әрекеттер әдепкі дұрыс шешім емес.
HTTP 504 тасымалдаушының бақылау жүйесі істен шыққанын білдіре ме?
Жоқ. Бұл шлюз немесе прокси жоғары деңгейдегі серверден уақытында жауап алмағанын білдіреді. Мәселе сол сұрау жолының кез келген жерінде болуы мүмкін. Бұл тасымалдаушының жалпы қолжетімділігін немесе сәлемдеменің күйін анықтамайды.
Тайм-ауттан кейін соңғы белгілі күйді көрсете аламын ба?
Иә, егер оны сәтті орындалған нақты уақыттағы жаңарту ретінде емес, соңғы қолжетімді ақпарат ретінде белгілесеңіз. Белгілі болған жағдайда оқиға уақытын және алыну уақытын көрсетіңіз, сондай-ақ жаңарақ жаңартудың расталмағанын анық айтыңыз.
Тайм-аут жөнелтілімді «тасымалдау үстінде» күйінен «ерекше жағдай» күйіне өзгертуі керек пе?
Жоқ. Тайм-аут — сұраудың сәтсіздігі, жөнелтілім оқиғасы емес. Жөнелтілім күйін тек сенімді бақылау дереккөзі өзгерісті қолдайтын оқиғаны немесе күйді берген кезде өзгертіңіз.
Уақыты аяқталған сұрау бақылау жазбасын жасап немесе тіркеп жатқан болса не істеу керек?
Ол сәтсіз аяқталды деп ойламаңыз. Жауап жоғалмай тұрып, қашықтағы жүйе оны өңдеп қойған болуы мүмкін. Оны қайта жібермес бұрын бар нәтижені тексеріп, құжатталған идемпотенттілік тетігін немесе провайдер мақұлдаған қалпына келтіру рәсімін пайдаланыңыз.
Дереккөздер
- RFC 9110, HTTP Semantics — HTTP күй анықтамалары,
Retry-Afterжәне сұрауларды қайталауға қатысты мәселелер. - RFC 6585, Additional HTTP Status Codes — HTTP 429 анықтамасы және оның
Retry-Afterарқылы қолданылуы. - Amazon Builders’ Library, “Timeouts, retries, and backoff with jitter” — қайталаулардың күшеюі, кері шегіну және кездейсоқ ауытқу туралы инженерлік нұсқаулық.
- 17TRACK Tracking API documentation — іске асыру алдында провайдерге тән API әрекетін тексеруге арналған анықтамалық.


