Мазмұнға өту
Блог

Туристік API кідірісі: нені түзете аласыз, нені түзете алмайсыз

Tekravel редакциясы
Жасанды интеллекттің көмегімен жазылған

Тикетте "іздеу баяу" деп жазылған. Алматы–Дубай барып-қайту рейсінің trace-ін ашасыз, сонда өз кодыңыз басында жіңішке бір жолақ, соңында тағы біреу. Арадағының бәрі — күту: GDS-ті, екі NDC әуе компаниясын, қашан көңілі қаласа сонда жауап беретін қонақүй агрегаторын. Туристік API кідірісі — профайлер үнемі сіз жазбаған және deploy ете алмайтын кодты көрсететін жалғыз өнімділік мәселесі. Бұл "түзетудің" мағынасын өзгертеді, ал командалардың оған жұмсайтын күшінің көбі қате жартыға кетеді.

Көп жеткізушілі іздеуде туристік API кідірісі шын мәнінде қайда кетеді

Брондау қозғалтқышындағы бір рейс іздеу — бір сұрау емес. Бұл fan-out. Қозғалтқыш ұшу нүктесін, баратын жерін, күндерін және жолаушылар құрамын алады, осы бағыт бойынша сұрауға рұқсаты бар әрбір дереккөзге жеткізушіге тән сұрау құрады, бәрін бір мезгілде жібереді, сосын күтеді. Әр жеткізушінің өз сағаты бар: жылы болған немесе болмаған GDS сессиясы, әуе компаниясы жағында қайта бағалап жатқан NDC шлюзі, өзі артындағы арна менеджерлеріне fan-out жасап жатқан bedbank. Пайдаланушыға көрсете алатын жауаптың төменгі шегін орташа емес, күтуге шешім қабылдаған ең баяу жеткізуші белгілейді.

Ең алдымен ұғынатын нәрсе осы. Жеткізуші қосу толық іздеуді ешқашан жылдамдатпайды. Ол тек бүкіл нәтиже жиыны "дайын" болмай тұрып өтуі керек тағы бір жолақ қосады.

Сосын жауаптар келеді де, шынымен сізге тиесілі жұмыс басталады: әр жеткізушінің үлкен XML немесе JSON жүктемесін parse ету, олардың әуежай, әуе компаниясы және тариф кодтарын өзіңіздікіне map ету, үш дереккөз үш бағамен қайтарған бір маршрутты dedup жасау, қай tenant сұраса соның markup ережелерін қолдану, валютаны ауыстыру және сұрыптау. Қарбалас бағытта бұл кезең тегін емес, және профайлер сізге пайдалы нәрсе айтатын жалғыз жер осы. Мәселенің қонақүй жағы туралы баяу жеткізушілерге арналған қонақүй қолжетімділік клиентін жобалау мақаласында жаздық; рейс жағының пішіні сондай, тек map етілетін кодтар көбірек.

Сонымен, баяу іздеудің адал бөлінісі — үш қорап:

  • Жеткізушіні күту — ең ұзақ жалғыз жеткізуші жауабы. Оны сіз басқармайсыз.
  • Сіздің кейінгі өңдеуіңіз — parse, map, dedup, баға, сұрыптау. Мұның бәрін сіз басқарасыз.
  • Жеткізу — біріктірілген нәтижені serialize етіп браузерге жеткізу. Әдетте шағын, кейде тосын.

Түзете алатын жарты және түзетуге тырысуды қоюға тиіс жарты

Екінші қораптан бастаңыз, өйткені ол сіздікі. Әдеттегі табыстар, әдетте шығатын ретімен: кестені бір рет жүктеудің орнына әр әуежай кодын дерекқордан жеке-жеке іздейтін map қадамы; іздеу бойынша емес, тариф бойынша бағам қызметін шақыратын валюта ауыстыру; әр маршрутты әр басқасымен салыстыратын dedup рутині; әр tenant үшін нысан графын қайта айналып өтетін serialization. Мұның ешқайсысы экзотика емес. Бәрі бір спринтте түзеледі және түзету сақталады.

Ұтыс шын болатын тағы бір жер — қосылым басқару. Әр іздеуде жеткізушіге жаңа TLS handshake — таза артық жүк; іздеулер арасында тірі сақталатын жылы қосылымдар пулы оны жояды. Әсіресе GDS сессияларын ашу қымбат, қайта пайдалану арзан, сондықтан ол әлемде сессия басқару — іске асыру бөлшегі емес, өнім мүмкіндігі.

Енді түзетуді қою керек жарты. Жеткізушіні жылдамырақ жауап беруге мәжбүрлей алмайсыз. Аккаунт менеджеріңізге айқайлай аласыз, кейде бағыт жылдамырақ node-қа көшіріледі, бірақ бөтен жүйенің жауап уақыты сіздің deployment-іңіздегі айнымалы емес. Мұны ұмытқан командалар тоқсандар бойы өз кейінгі өңдеуін жіңішке жолақтан одан да жіңішке жолаққа дейін қырады, ал жиынтықтың көп бөлігі болған жеткізушіні күту орнынан қозғалған жоқ. Профайлер оларға адал болды. Олар жай оның дұрыс деген бөлігін оңтайландыра берді.

Баяу жеткізуші туралы істей алатыныңыз — оны қанша күтуге дайын екеніңізді және сол кезде пайдаланушы не көретінін шешу. Мақаланың қалғаны сол туралы.

Кезеңдік көрсету — адал жауап

Толық нәтиже жиынының шегін ең баяу жеткізуші белгілесе, пайдаланушыға бірдеңені ертерек көрсетудің жалғыз жолы — жиынның толық болуын күтуді қою. Бірінші жауап берген жеткізушінің нәтижелерін көрсетіңіз. Келесі жеткізушінің нәтижелері келгенде қосыңыз. Кешіккендер әлі жолда болғанда пайдаланушы оқуды, сүзуді және салыстыруды бастасын. Бұл — кезеңдік көрсету, және ол айла емес; серверде шын мәнінде не болып жатқанының дәл бейнесі.

Оның кейін анықтаудың орнына алдын ала жобалауға тұрарлық салдары бар:

  • Сұрыптау тұрақтылығы. Әр жеткізуші келген сайын қайта сұрыпталатын баға бойынша тізім пайдаланушы басайын деп тұрған тарифті жылжытады. Жаңа нәтижелерді орнына кірістіріңіз немесе топтап, пайдаланушы өзі тартсын, бірақ курсор астындағы тізімді араластырмаңыз.
  • "Ең арзан" — уақытша. Соңғы жеткізуші келгенше ең төмен тариф туралы кез келген мәлімдеме — тек жауап берген жеткізушілер туралы мәлімдеме. Интерфейс толықтықты ойнамай, осы күйді көрінетін етуі керек.
  • Брондау қадамы қайта тексеруі тиіс. Ерте жауаптан көрсетілген тариф пайдаланушы басқанша жоғалып кетуі мүмкін. Бұл кезеңдік емес дизайндарда да рас, бірақ кезеңдік көрсету терезені үлкейтеді. Брондау интеграциясы мақаласы қайта бағалау қадамын қамтиды; мұнда ол міндетті.
  • Кэштеу қиындамайды, жеңілдейді. Жеткізуші бойынша нәтижелерді жеткізуші бойынша өмір сүру мерзімімен кэштеуге болады. Bedbank-тің статикалық бағалары сағаттап тұра алады; NDC ұсынысы — минуттап. Бір тұтас біріктірілген нәтиже бәріне ең қысқа мерзімді таңады.

Мұны қолдайтын API пішіні — бірден идентификатор қайтарып, клиентке нәтижелерді келген сайын poll етуге немесе жазылуға мүмкіндік беретін іздеу, әр топтама дереккөзбен белгіленген және іздеудің әлі ашық екенін айтатын жалаушасы бар. Платформаның өз рейс және қонақүй API-лері дәл осы пішіннің төңірегінде құрылған; туристік API-лер беті беттерін сипаттайды, ал қолжетімділік self-service кілтпен емес, әңгімемен басталады, сондықтан сұрақтарыңызды ала келіңіз.

Timeout сұрау бойынша емес, жеткізуші бойынша

Бүкіл іздеуге бір timeout — бұл қабаттағы ең жиі қате, және ол бір мезгілде екі бағытта да қате. Қысқа қойсаңыз, баяу бірақ құнды жеткізуші әр іздеуде кесіледі де, сіз оның инвентарын сатуды үнсіз тоқтатасыз. Ұзақ қойсаңыз, бір ілініп қалған жеткізуші әр нәтижені, соның ішінде бірден келгендерді де, кепілде ұстайды.

ШешімБүкіл іздеуге бір timeoutЖеткізуші бойынша бюджет
Бір жеткізуші ілінедіБәрі күтеді, сосын бәрі сәтсіз немесе бәрі кесіледіСол жеткізуші осы іздеуден алынады; қалғандары көрсетіледі
Жақсы тарифті баяу жеткізушіНе әрқашан шығарылады, не әрқашан бетті баяулатадыЖылдамдарынан ұзақ бюджет алады және кеш көрсетіледі
Қайта әрекетБүкіл fan-out қайталанады, жауап берген жеткізушілерге жүк екі есеТек сәтсіз болғаны қайталанады, егер жалпы қайталауға тұрса
Пайдаланушы не көредіSpinner, сосын не бәрі, не қатеТолып жатқан нәтижелер және ақыры жабылатын "әлі ізделуде" күйі
Операция командасы не көредіҚай дереккөз себеп болғаны көрсетілмеген "іздеу timeout болды"Жеткізушінің атының жанына қоюға болатын жеткізуші бойынша timeout саны
БаптауМәңгі таласатын бір санЖеткізуші бойынша бір сан, сол жеткізушінің өз тарихынан алынған

Жеткізуші бойынша бюджет — коммерциялық шындық тұратын жер де. Тарифтері сирек таңдалатын жеткізуші бағытта брондауыңыздың көбін ұтып алатынмен бірдей шыдамдылыққа лайық емес. Парсы шығанағы–Орталық Азия бағытында консолидатордың net тарифтері күтуге тұрарлық болуы мүмкін; алғашқы үшеуімен бірдей қонақүйлерді қайтаратын төртінші bedbank — жоқ. Бюджет — санмен өрнектелген өнім шешімі, оны жеткізуші бойынша, tenant-тар ерекшеленсе tenant бойынша белгілеп, қайта қарап отыру керек.

Өзін ақтайтын екі нақтылау. Біріншісі, бюджет тек максимум емес; бюджетінің аз бөлігінде, бірақ бос жиынмен оралатын жеткізуші timeout болғаннан басқа сигнал, екеуін бөлек санау керек. Екіншісі, қайта әрекеттер жеткізуші деңгейіне тиесілі және сирек болуы керек. Жаңа ғана timeout болған жеткізушіге іздеуді қайталау әдетте олардың жағында кезекте екі іздеу дегенді білдіреді, бұл келесісін де баяулатады, ал өлшенетін келісімшарттарда ақшаға түседі.

Санның мәні болуы үшін нені өлшеу керек

"Орташа іздеу уақыты" — бәрі есеп беретін және ең аз айтатын сан. Ол кэштелген қонақүй іздеуін алты жеткізушілі халықаралық fan-out-пен араластырады, себеп болған жеткізушіні жасырады және кодыңыз емес, трафик құрамы өзгергенде қозғалады. Оны әрқайсысы бір сұраққа жауап беретін шағын өлшемдер жиынымен ауыстырыңыз.

  1. Бірінші нәтижеге дейінгі уақыт, іздеу бойынша. Пайдаланушы жылдамдық ретінде сезінетін осы. Оның шегін ең жылдам жеткізушіңіз плюс өз артық жүгіңіз белгілейді, яғни шынымен жақсарта алатын бөлік.
  2. Аяқталуға дейінгі уақыт, іздеу бойынша, оны жапқан жеткізушінің кімдігімен. Бір жеткізуші әрқашан соңғы болса, бұл бюджет әңгімесі, инженерия емес.
  3. Жеткізуші бойынша жауап уақыты, орташа емес, үлестірім ретінде, бағыт пен тәулік уақытымен белгіленген. Таңертең жақсы, кешке баяу жеткізуші орташада жақсы көрінеді және жақсы емес.
  4. Нәтиже класы ретіндегі timeout-тар, "нәтиже қайтарды" және "бос қайтарды" дегендермен қатар, жеткізуші бойынша саналады. Timeout — сіз алмаған нәтиже, ол алғандарыңызбен бір диаграммаға тиесілі.
  5. Өз кейінгі өңдеу уақытыңыз, бөлек. Бұл өскенде сізде код мәселесі бар. Жеткізушіні күту өскенде сізде әңгіме бар.
  6. Бір брондауға іздеулер, жеткізуші және tenant бойынша. Жіберген әр іздеуіңіз жеткізушінің сыйымдылығына түседі, және келісімшарттардың көбі қатынасқа қарайды. Қайта әрекеттермен іздеу көлемін екі еселейтін кідіріс түзетуі санды жақсартпады, нашарлатты.

Пайдаланушы көретін нүктеде де өлшеңіз. Браузер баяу serialization қадамында күтіп тұрғанда жылдам іздеулер туралы есеп беретін сервер бір мезгілде шындықты айтады және сізді адастырады.

Мұны қате істеу сізге неге түседі

Айқын шығын — тикеттегі: күтіп, сосын кететін пайдаланушы. Айқын емес шығындар — коммерциялық. Тым қысқа қойылған іздеу бойы бір timeout әр іздеуде бір жеткізушіні нәтижелеріңізден үнсіз алып тастайды, ал сіз мұны аккаунт менеджері брондаулар неге тоқтады деп сұрағанда ғана білесіз. Бүкіл fan-out-тарды қайталау бір брондауға іздеулеріңізді екі еселейді, ал бұл қатынасты өлшейтін жеткізушілер сізді throttle етумен немесе шот жіберумен жауап береді. Кезеңдік тізімді пайдаланушының курсоры астында қайта сұрыптау қате тарифке қате басуларды туғызады, олар қолдау тикеттеріне, кейде қайтарымдарға айналады. Ал орташаға негізделген тақта үстіндегі сан жасыл күйінде тұрғанда осы үшеуінің бәріне жол береді.

Мұның ешқайсысы кодыңызды жылдамдатумен шешілмейді. Олар жеткізуші бойынша қанша күтетініңізді шешумен, күткенде пайдаланушыға барыңызды көрсетумен және шынымен қозғалған нәрсені өлшеумен шешіледі. Кодты жылдамдату істеуге тұрарлық. Тек қате болған бөлік ол емес еді.

Tekravel редакциясы

Туристік технологиялар бөлімі

Tekravel-тің туристік технологиялар бөлімі сала мамандарына жазады: агенттік иелеріне, консолидаторларға және оларды интеграциялайтын әзірлеушілерге. Әрбір мақала жарияланбас бұрын өзі сипаттайтын платформада тексеріледі.