Seyahat API gecikmesi: neyi düzeltebilir, neyi düzeltemezsiniz

Destek kaydında tek cümle var: "Arama yavaş." İstanbul–Dubai gidiş-dönüş için izi açıyorsunuz; kendi kodunuz başta ince bir dilim, sonda bir dilim daha. Arada kalan her şey bekleme: bir GDS'i, iki NDC havayolunu, canı ne zaman isterse o zaman cevap veren bir otel toplayıcısını beklemek. Seyahat API gecikmesi, profil aracının sürekli sizin yazmadığınız ve deploy edemeyeceğiniz kodu gösterdiği tek performans sorunudur. Bu, "düzeltmek"in anlamını değiştirir ve ekiplerin bu işe harcadığı emeğin çoğu yanlış yarıya gider.
Çok tedarikçili aramada seyahat API gecikmesi gerçekte nereye gidiyor
Bir rezervasyon motorunda tek bir uçuş araması tek bir istek değildir; bir yelpaze açılımıdır. Motor kalkış, varış, tarihler ve yolcu bileşimini alır, o rota için sorgulamasına izin verilen her kaynağa tedarikçiye özel bir istek kurar, hepsini aynı anda gönderir ve bekler. Her tedarikçinin kendi saati vardır: ısınmış ya da ısınmamış bir GDS oturumu, havayolu tarafında yeniden fiyatlama yapan bir NDC ağ geçidi, arkasındaki kanal yöneticilerine kendisi de yelpaze açan bir bedbank. Kullanıcıya gösterebileceğiniz sonuç, ortalamayla değil, beklemeyi seçtiğiniz en yavaş tedarikçiyle alttan sınırlıdır.
İçselleştirilecek ilk şey bu. Tedarikçi eklemek tam bir aramayı asla hızlandırmaz. Yalnızca, sonuç kümesi "bitti" sayılmadan önce temizlenmesi gereken bir şerit daha ekler.
Sonra yanıtlar gelir ve sahibi olduğunuz iş başlar: tedarikçi başına büyük bir XML ya da JSON yükünü ayrıştırmak, onların havalimanı, havayolu ve ücret kodlarını sizinkilere eşlemek, üç kaynağın üç fiyatla döndürdüğü aynı güzergâhı tekilleştirmek, soran kiracının markup kurallarını uygulamak, TL'ye ya da EUR'ya çevirmek ve sıralamak. Yoğun bir rotada bu aşama bedava değildir ve profil aracının size uygulanabilir bir şey söyleyeceği tek yerdir. Otel tarafını yavaş tedarikçiler için otel müsaitlik istemcisi tasarımı yazısında ele almıştık; uçuş tarafı aynı şekle sahiptir, eşlenecek daha çok kodla.
Yavaş bir aramanın dürüst dökümü üç kovadır:
- Tedarikçi beklemesi: en uzun tekil tedarikçi yanıtı. Kontrol edemezsiniz.
- Sizin son işlemeniz: ayrıştır, eşle, tekilleştir, fiyatla, sırala. Tamamını kontrol edersiniz.
- Teslimat: birleşik sonucu serileştirip tarayıcıya ulaştırmak. Genelde küçük, ara sıra sürpriz.
Düzeltebileceğiniz yarı ve düzeltmeye çalışmayı bırakmanız gereken yarı
İkinci kovayla başlayın, çünkü sizin. Olağan bulgular, görünme sırasıyla: tabloyu bir kez yüklemek yerine her havalimanı kodunu veritabanında tek tek arayan bir eşleme adımı; arama başına değil ücret başına kur servisini çağıran bir döviz çevirisi; her güzergâhı diğer her güzergâhla karşılaştıran bir tekilleştirme rutini; nesne grafını her kiracı için yeniden dolaşan bir serileştirme. Hiçbiri egzotik değil. Hepsi bir sprintte düzeltilir ve düzeltme kalıcıdır.
Bağlantı yönetimi, kazancın gerçek olduğu diğer yerdir. Her aramada tedarikçiye yeni bir TLS el sıkışması saf ek yüktür; aramalar arasında canlı tutulan sıcak bağlantı havuzu bunu ortadan kaldırır. Özellikle GDS oturumları açması pahalı, yeniden kullanması ucuzdur; o dünyada oturum yönetiminin bir uygulama ayrıntısı değil ürün özelliği olmasının nedeni budur.
Şimdi düzeltmeyi bırakılacak yarı. Bir tedarikçiyi daha hızlı yanıt vermeye zorlayamazsınız. Hesap yöneticinize bağırabilirsiniz, bazen bir rota daha hızlı bir düğüme taşınır; ama başkasının sisteminin yanıt süresi sizin deployment'ınızda bir değişken değildir. Bunu unutan ekipler, toplamın çoğunu oluşturan tedarikçi beklemesi yerinden kıpırdamamışken, kendi son işlemelerini ince dilimden daha ince dilime indirmekle çeyrekler harcar. Profil aracı onlara karşı dürüsttü. Onlar sadece aracın "sorun yok" dediği parçayı iyileştirmeye devam ettiler.
Yavaş bir tedarikçi hakkında yapabileceğiniz şey, onu ne kadar beklemeye hazır olduğunuza ve bu sırada kullanıcının ne göreceğine karar vermektir. Yazının geri kalanı bu.
Kademeli gösterim dürüst cevaptır
Tam sonuç kümesi en yavaş tedarikçiyle sınırlıysa, kullanıcıya daha erken bir şey göstermenin tek yolu kümenin tamamlanmasını beklemeyi bırakmaktır. İlk yanıt veren tedarikçinin sonuçlarını gösterin. Bir sonraki tedarikçinin sonuçlarını geldiğinde ekleyin. Geride kalanlar hâlâ yoldayken kullanıcının okumaya, filtrelemeye ve karşılaştırmaya başlamasına izin verin. Bu kademeli gösterimdir ve bir numara değildir; sunucuda gerçekte olanın doğru bir temsilidir.
Keşfetmek yerine tasarlanmaya değer sonuçları vardır:
- Sıralama kararlılığı. Her tedarikçi geldiğinde yeniden sıralanan bir fiyat listesi, kullanıcının tıklamak üzere olduğu ücreti yerinden oynatır. Yeni sonuçları yerine ekleyin ya da toplayıp kullanıcının kendisi çekmesine izin verin; ama imlecin altında karıştırmayın.
- "En ucuz" geçicidir. Son tedarikçi gelene kadar her en düşük ücret iddiası yalnızca yanıt vermiş tedarikçiler hakkında bir iddiadır. Arayüz tamlık taklidi yapmak yerine bu durumu görünür kılmalıdır.
- Rezervasyon adımı yeniden kontrol etmelidir. Erken bir yanıttan gösterilen ücret, kullanıcı tıkladığında gitmiş olabilir. Bu kademeli olmayan tasarımlarda da doğrudur, ama kademeli gösterim pencereyi büyütür. Rezervasyon entegrasyonu yazısı yeniden fiyatlama adımını anlatır; burada isteğe bağlı değildir.
- Önbellekleme zorlaşmaz, kolaylaşır. Tedarikçi başına sonuçlar tedarikçi başına ömürle önbelleklenebilir. Bir bedbank'in statik oranları saatlerce yaşayabilir; bir NDC teklifi dakikalarca. Tek bir yekpare birleşik sonuç, en kısa ömrü her şeye dayatır.
Bunu destekleyen API şekli, hemen bir tanımlayıcı döndüren ve istemcinin sonuçları geldikçe yoklamasına ya da abone olmasına izin veren bir aramadır; her parti kaynağıyla etiketlenir ve aramanın hâlâ açık olup olmadığını söyleyen bir bayrak taşır. Platformun kendi uçuş ve otel API'leri bu şekil etrafında kurulmuştur; seyahat API'leri sayfası yüzeyleri anlatır ve erişim self-servis bir anahtarla değil bir görüşmeyle başlar, o yüzden sorularınızı getirin.
İstek başına değil, tedarikçi başına zaman aşımı
Tüm aramaya tek bir zaman aşımı bu katmandaki en yaygın hatadır ve aynı anda iki yönde yanlıştır. Kısa tutun; yavaş ama değerli bir tedarikçi her aramada kesilir ve sessizce envanterini satmayı bırakırsınız. Uzun tutun; askıda kalan tek bir tedarikçi, anında gelenler dahil her sonucu rehin tutar.
| Karar | Tüm arama için tek zaman aşımı | Tedarikçi başına bütçe |
|---|---|---|
| Bir tedarikçi askıda kalır | Herkes bekler, sonra herkes başarısız olur ya da kesilir | O tedarikçi bu aramadan düşürülür; kalanlar gösterilir |
| İyi ücretli yavaş tedarikçi | Ya hep dışarıda ya da hep sayfayı yavaşlatıyor | Hızlılardan daha uzun bütçe alır ve geç gösterilir |
| Yeniden deneme | Tüm yelpaze yeniden denenir; zaten yanıtlamış tedarikçilerin yükü ikiye katlanır | Yalnızca başarısız olan yeniden denenir, denemeye değerse |
| Kullanıcının gördüğü | Dönen simge, sonra ya her şey ya hata | Dolan sonuçlar ve sonunda kapanan bir "hâlâ aranıyor" durumu |
| Operasyonun gördüğü | Hangi kaynağın neden olduğuna dair iz olmadan "Arama zaman aşımına uğradı" | Tedarikçi adının yanına konabilen tedarikçi başına zaman aşımı sayısı |
| Ayarlama | Sonsuza kadar tartışılan tek sayı | Her tedarikçi için kendi geçmişinden türetilen bir sayı |
Tedarikçi başına bütçe aynı zamanda ticari gerçekliğin yaşadığı yerdir. Ücretleri nadiren seçilen bir tedarikçi, bir rotada rezervasyonlarınızın çoğunu kazananla aynı sabrı hak etmez. Bir konsolidatörün Türkiye–Körfez rotasındaki net ücretleri beklemeye değebilir; ilk üçünün döndürdüğü otelleri yeniden döndüren dördüncü bir bedbank değmez. Bütçe, sayıyla ifade edilmiş bir ürün kararıdır; tedarikçi başına, kiracılar farklıysa kiracı başına ayarlanmalı ve gözden geçirilmelidir.
Kendini amorti eden iki incelik. Birincisi, bütçe yalnızca bir üst sınır değildir; bütçesinin küçük bir kısmında ama boş kümeyle dönen bir tedarikçi, zaman aşımına uğrayandan farklı bir sinyaldir ve ikisi ayrı sayılmalıdır. İkincisi, yeniden denemeler tedarikçi düzeyine aittir ve nadir olmalıdır. Az önce zaman aşımına uğramış bir tedarikçiye yeniden arama göndermek, genellikle onların tarafında kuyrukta iki arama demektir; bir sonrakini de yavaşlatır ve ölçülen sözleşmelerde para tutar.
Sayının bir anlamı olsun diye ne ölçmeli
"Ortalama arama süresi" herkesin raporladığı ve en az şey söyleyen sayıdır. Önbellekteki bir otel sorgusunu altı tedarikçili uluslararası bir yelpazeyle harmanlar, nedeni olan tedarikçiyi gizler ve kodunuz değiştiğinde değil trafik karışımı değiştiğinde oynar. Yerine her biri tek bir soruya cevap veren küçük bir ölçüm kümesi koyun.
- İlk sonuca kadar geçen süre, arama başına. Kullanıcının hız olarak deneyimlediği budur. En hızlı tedarikçiniz artı kendi ek yükünüzle sınırlıdır, yani gerçekten iyileştirebileceğiniz kısımla.
- Tamamlanmaya kadar geçen süre, arama başına, aramayı kapatan tedarikçinin kimliğiyle. Bir tedarikçi hep sonuncuysa bu bir bütçe görüşmesidir, mühendislik değil.
- Tedarikçi başına yanıt süresi, ortalama değil dağılım olarak; rota ve günün saatiyle etiketli. Sabah iyi, akşam yavaş bir tedarikçi ortalamada iyi görünür ve değildir.
- Sonuç sınıfı olarak zaman aşımları, tedarikçi başına "sonuç döndürdü" ve "boş döndürdü" yanında sayılır. Zaman aşımı alamadığınız bir sonuçtur ve aldıklarınızla aynı grafikte yeri vardır.
- Kendi son işleme süreniz, ayrı olarak. Bu büyüyorsa kod sorununuz var. Tedarikçi beklemesi büyüyorsa bir görüşmeniz var.
- Rezervasyon başına arama, tedarikçi ve kiracı başına. Gönderdiğiniz her arama tedarikçiye kapasiteye mal olur ve çoğu sözleşme bu oranı önemser. Yeniden denemelerle arama hacminizi ikiye katlayan bir gecikme düzeltmesi sayıyı daha iyi değil daha kötü yapmıştır.
Kullanıcının gördüğü noktada da ölçün. Tarayıcı yavaş bir serileştirme adımını beklerken hızlı aramalar raporlayan bir sunucu aynı anda hem doğruyu söyler hem sizi yanıltır.
Bunu yanlış yaparsanız size neye mal olur
Bariz maliyet kayıttaki: bekleyip giden kullanıcı. Daha az bariz olanlar ticaridir. Çok kısa ayarlanmış tek bir arama geneli zaman aşımı, her aramada bir tedarikçiyi sonuçlarınızdan sessizce çıkarır ve bunu ancak hesap yöneticisi rezervasyonların neden durduğunu sorduğunda öğrenirsiniz. Tüm yelpazeleri yeniden denemek rezervasyon başına aramanızı ikiye katlar; bu oranı ölçen tedarikçiler sizi kısarak ya da fatura keserek karşılık verir. Kademeli bir listeyi kullanıcının imleci altında yeniden sıralamak yanlış ücrete yanlış tıklamalar üretir; bunlar destek kaydına, bazen iadeye dönüşür. Ortalamaya dayalı bir pano ise üstündeki sayı yeşil kalırken bu üçünün de olmasına izin verir.
Bunların hiçbiri kodunuzu hızlandırarak çözülmez. Tedarikçi başına ne kadar bekleyeceğinize karar vererek, beklerken kullanıcıya elinizdekini göstererek ve gerçekten oynayan şeyi ölçerek çözülür. Kod hızlandırmaları yapmaya değer. Sadece yanlış olan kısım onlar değildi.