Skip to main content
AnasayfaBlogKılavuzlarGerçek Zamanlı Takip İsteği Zaman Aşımına mı Uğradı? İzlenecek Yeniden Deneme, Geri Dönüş ve Durum Kuralları

Gerçek Zamanlı Takip İsteği Zaman Aşımına mı Uğradı? İzlenecek Yeniden Deneme, Geri Dönüş ve Durum Kuralları

17TRACK

Gerçek zamanlı izleme isteği zaman aşımına uğradığında, gönderinin en son durumunu gecikmiş, kayıp veya değişmemiş olarak değil, bilinmiyor şeklinde değerlendirin. Yalnızca sınırlı bir zaman bütçesi içinde yeniden deneyin; ardından açıkça etiketlenmiş, bilinen son güncellemeyi gösterin veya kullanıcıdan daha sonra tekrar kontrol etmesini isteyin. Süreç boyunca istek sonucunu, verilerin güncelliğini ve paketin gerçek durumunu birbirinden ayrı tutun.

Gerçek Zamanlı İzleme İsteğinde Zaman Aşımı, Yeniden Deneme, Geri Dönüş ve Durum

Bu ayrım hem müşteriye yönelik izleme sayfaları hem de bildirimleri veya destek iş akışlarını tetiklemek için izleme verilerini kullanan sistemler açısından önemlidir. Zaman aşımı, bir yanıtın zamanında ulaşmadığını gösterir. Taşıyıcının yeni bir olay kaydedip kaydetmediğini, üst düzey bir hizmetin isteği işleyip işlemediğini veya paketin hareket edip etmediğini göstermez.

Öncelikle neyin zaman aşımına uğradığını belirleyin

Bir izleme isteği birkaç noktada başarısız olabilir: tarayıcı uygulamanızı beklemeyi durdurabilir, uygulamanız bir izleme API’sini beklemeyi durdurabilir veya bu API başka bir hizmetle iletişim kurarken zaman aşımına uğrayabilir. Kullanıcı her durumda aynı genel hatayı görebilir, ancak uygun sonraki işlem farklıdır.

  • İstemci tarafı zaman aşımı: Uygulama beklemeyi durdurdu. Sunucu tarafındaki istek yine de tamamlanmış olabilir. Çalışmayı tekrarlayabilecek başka bir istek göndermeden önce kendi istek günlüklerinizi veya sonuç deponuzu kontrol edin.
  • Ağ veya bağlantı hatası: Sisteminiz kullanılabilir bir yanıt almadı. Uzak hizmetin isteği işleyip işlemediğini bilemeyebilirsiniz.
  • HTTP 504: Bir ağ geçidi veya proxy, üst düzey bir sunucudan zamanında yanıt alamadı. Bu, gönderiyi değil istek yolunu tanımlar.
  • HTTP 408: Sunucu, beklemeye hazır olduğu süre içinde eksiksiz bir istek mesajı almadı. Bu, taşıyıcıya ait bir izleme durumu değildir.
  • Eski bir olayla birlikte HTTP 200: İstek başarılı oldu, ancak döndürülen izleme bilgileri hâlâ güncel olmayabilir. Başarılı bir HTTP yanıtı güncellik garantisi değildir.

Bu sonuçları istek tanılamaları olarak kaydedin. Bunların hiçbirini “taşımada”, “istisna” veya “teslim edildi” gibi gönderi etiketlerine dönüştürmeyin. Bu etiketler taşıma katmanından değil, izleme olaylarından veya belgelenmiş bir durum alanından gelmelidir.

Açık uçlu döngü yerine sınırlı yeniden deneme kullanın

Salt okunur bir izleme sorgusu için zaman aşımından sonra yeniden denemek çoğu zaman makuldür. Ancak bu işlem yine de sınırlandırılmalıdır. Tekrarlanan istekler, zorlanan bir hizmet üzerindeki yükü artırabilir, kullanıcının bekleme süresini uzatabilir ve birkaç uygulama katmanı bağımsız olarak yeniden denediğinde yinelenen çalışmalar oluşturabilir.

  1. Toplam bir son tarih belirleyin. İlk deneme ve olası yeniden denemeler dâhil olmak üzere, kullanıcıya sunulan işlemin ne kadar sürebileceğine karar verin. Her denemeye, çağıranın bekleyebileceği süreyi aşan yeni ve tam bir son tarih vermeyin.
  2. İşlemin tekrarlanmasının güvenli olup olmadığını kontrol edin. Bir sorgu genellikle gönderi kaydeden, ayarları değiştiren veya kaynak oluşturan bir istekten farklıdır. Sağlayıcının sözleşmesi veya idempotensi kontrolleriniz bunu güvenli hâle getirmedikçe durum değiştiren bir isteği otomatik olarak yeniden yürütmeyin.
  3. Geçici bir hatayı ölçülü şekilde yeniden deneyin. Küçük ve açıkça tanımlanmış bir yeniden deneme bütçesi ile birçok istemciden aynı anda anında yeniden deneme göndermek yerine jitter içeren bir gecikme kullanın.
  4. Geçerli sunucu talimatlarına uyun. Yanıt geçerli bir Retry-After üst bilgisi içeriyorsa daha erken bir yeniden deneme planlamayın. Ayrıca daha sıkı uygulama veya sağlayıcıya özgü sınırlara da uyun.
  5. Son tarih veya bütçe tükendiğinde durun. Bir geri dönüş yanıtına geçin ve iş akışınız gerektiriyorsa sonraki mutabakatı ayrı olarak planlayın.

Uygulanabilir bir tasarım, yeterli zaman kalmışsa kullanıcıya yönelik bir yeniden denemeye izin verirken sonraki denemeleri arka plan yenilemesine taşıyabilir. Bu, evrensel bir API kuralı değil, bir politika örneğidir. Sınırları hizmet düzeyi hedeflerinize, gözlemlenen gecikmeye ve sağlayıcının belgelerine göre belirleyin. Ayrıca HTTP kitaplıkları, ağ geçitleri ve iş çalışanları tarafından yapılan yeniden denemeleri de sayın; aksi hâlde görünüşte mütevazı bir uygulama politikası çok sayıda üst düzey çağrı üretebilir.

HTTP 429 için yanıtı hemen yeniden deneme nedeni değil, hız sınırı sinyali olarak değerlendirin. HTTP 503, isteğin geçici olarak işlenemediğini gösterebilir ve sunucu Retry-After sağlayabilir. 504 geçici olabilir, ancak sonraki denemenin çalışacağını garanti etmez. Kimlik doğrulama hataları genellikle kimlik bilgileri veya izin kontrolleri gerektirirken, hatalı biçimlendirilmiş istekler girdilerin düzeltilmesini gerektirir. “Bulunamadı” sonucu veren bir izleme tanımlayıcısı daha dikkatli değerlendirilmelidir: sağlayıcının belgelenmiş davranışına ve gönderinin aşamasına bağlı olarak bir kaydı bulmak için henüz erken olabilir veya tanımlayıcı yanlış olabilir. Böyle bir sonucu, paketin var olmadığına dair kesin bir iddiaya dönüştürmeyin.

Bildiğiniz bilgileri koruyan bir geri dönüş seçin

En güvenli geri dönüş genellikle, kendi olay zamanı ve dürüst bir güncellik etiketiyle birlikte doğrulanmış son izleme sonucudur. Bu sonucu mevcut istek hatasından ayrı tutun. Bir sayfa şöyle diyebilir: “Kullanılabilir en son güncelleme: Tesisten ayrıldı. Son kontrol: [zaman]. Daha yeni bir güncelleme geçici olarak kullanılamıyor.” “Son kontrol” ifadesini yalnızca sisteminiz bunu gerçekten kaydediyorsa kullanın; bu ifade taşıyıcı olay zamanının yerine geçmez.

Destekleyebildiğiniz en belirli zamanı kullanın. Taşıyıcı olay zamanı, bildirilen bir olayın ne zaman gerçekleştiğini ifade eder. Sisteminizin bu olayı aldığı zaman, veri alımını ifade eder. Kullanıcının sayfayı açtığı zaman ise bunların hiçbirini ifade etmez. Kaynak güvenilir bir olay zamanı veya saat dilimi sağlamıyorsa bunu uydurmayın. Benzer şekilde, önbelleğe alınan sonuçta kayıtlı bir alınma zamanı yoksa, yakın zamanda yenilendiğini iddia etmek yerine buna “kullanılabilir son güncelleme” deyin.

Bir geri dönüş şu üç sınırı izlemelidir:

  • Önbelleğe alınan veriyi önbelleğe alınmış veri olarak gösterin. Eski bir olayı zaman aşımına uğrayan isteğin sonucu olarak sunmayın.
  • Geçen zamandan ilerleme çıkarımı yapmayın. Bir paket birkaç gündür taşımada olduğu için yalnızca bu nedenle “dağıtıma çıktı” değildir.
  • Önemli belirsizliği gizlemeyin. Önceki bir sonuç yoksa, uydurma bir varsayılan durum göstermek yerine izlemenin geçici olarak kullanılamadığını söyleyin.

Diğer geri dönüş yolları arasında önceden senkronize edilmiş bir izleme deposu, yetkili bir taşıyıcı sorgusu veya daha sonraki bir arka plan yenilemesi bulunabilir. Bunları yalnızca gönderiye, izinlerinize ve veri kaynağının şartlarına uygunsa kullanın. İkinci bir kaynak farklı olay adlarına veya raporlama gecikmelerine sahip olabilir; bu nedenle kaynağı koruyun ve bunu yapmaya yönelik bir kural olmadan çelişkili kayıtları birleştirmekten kaçının. Müşteri sonuca göre işlem yapabiliyorsa, döndürücüyü süresiz bırakmak yerine yeniden deneme veya destekle iletişim kurma olanağı sağlayın.

İstek durumunu, veri güncelliğini ve gönderi durumunu ayrı tutun

Bunlar, kullanıcı arayüzü bunları birlikte gösterse bile üç farklı alandır. İstek durumu, sorgunun başarılı olup olmadığını, zaman aşımına uğrayıp uğramadığını veya hata alıp almadığını belirtir. Veri güncelliği, döndürülen veya depolanan bilgilerin ne zaman gözlemlendiğini belirtir. Gönderi durumu, izleme kaynağının paket hakkında ne bildirdiğini belirtir. Bunları ayırmak, geçici bir API hatasının geçerli bir teslimat olayının üzerine yazmasını veya eski bir taşımada olayının güncel bir iddiaya dönüştürülmesini önler.

Örneğin bir sistem, önceki bir sorgudan alınmış doğrulanmış bir “Teslim edildi” olayını tutarken mevcut yenileme zaman aşımına uğrayabilir. Teslimat olayı ortadan kalkmaz. Doğru birleşik durum, kullanılabilir son gönderi durumunun teslim edildiği ve en son yenilemenin başarısız olduğudur. Buna karşılık son olay “Taşımada” ise zaman aşımı, paketin şu anda taşımada kaldığını doğrulamaz; yalnızca daha yeni bir yanıt alınamadığını doğrular.

Olaylar sıra dışı geldiğinde tanımlanmış bir kural uygulayın. Kullanılabilir olduğunda olay tanımlayıcılarını, zaman damgalarını, kaynağı ve sağlayıcının belgelenmiş durum anlamlarını karşılaştırın. Sisteminizin güncellemeleri alma sırasının gönderi olaylarının gerçekleşme sırası olduğunu varsaymayın. Geç gelen daha eski bir olay da otomatik olarak daha yeni doğrulanmış durumun yerini almamalıdır. Ancak düzeltmeler ve istisnalar meşru olabilir; bu nedenle teslimattan sonraki durum değişikliklerini imkânsız sayan genel bir kural kullanmayın. Temel olayları koruyun ve geçmişi sessizce yeniden yazmak yerine çelişkileri araştırın.

Bir sağlayıcı HTTP 202 döndürürse bunu ilgili uç noktanın sözleşmesine göre yorumlayın: bir isteğin kabul edilmesi, tek başına izleme sorgusunun tamamlandığı anlamına gelmez. Benzer şekilde HTTP 200, HTTP isteğinin o uç noktanın anlamına göre başarılı olduğunu gösterir; her izleme alanının mevcut veya güncel olduğunu kanıtlamaz. Sağlayıcıya özgü yanıt alanlarını yalnızca sağlayıcının belgelerini kontrol ettikten sonra eşleyin.

Müşterileri alarma geçirmeden hatayı operatörler için görünür kılın

Yararlı bir operasyon kaydı; istek kimliğini, uç noktayı veya işlemi, deneme sayısını, geçen süreyi, zaman aşımı katmanını, alınmışsa HTTP durumunu ve yanıtın canlı bir sorgudan mı yoksa geri dönüşten mi geldiğini içerir. İzleme verileri için kaynağı ve ilgili olay veya alınma zaman damgalarını kaydedin. İzleme numaralarını ve müşteri bilgilerini kuruluşunuzun erişim ve saklama kurallarına uygun şekilde işleyin; tanılama yararı, tam tanımlayıcıları sınırsız günlüklerde açığa çıkarmak için bir gerekçe değildir.

Tek bir zaman aşımına güvenmek yerine örüntüleri izleyin. Bir taşıyıcı rotasında artan zaman aşımı oranı, tekrarlanan 429 yanıtları veya taşıyıcı olay zamanı ile alınma zamanı arasındaki açığın büyümesi farklı sorunlara işaret edebilir. İlki sağlayıcı incelemesi, ikincisi hız kontrolü, üçüncüsü ise senkronizasyonun veya olay iletiminin kontrol edilmesini gerektirebilir. Bir uygulama 17TRACK Tracking API gibi bir sağlayıcı üzerinden izleme sunuyorsa, bu genel kuralları uygulamadan önce uç noktaya özgü yanıt alanlarını, istek sınırlarını ve hata işlemeyi doğrulamak için sağlayıcının belgelerini kullanın.

Müşteriye yönelik mesaj için kesin ve ölçülü olun: “İzlemeyi şu anda yenileyemedik. Kullanılabilir en son güncelleme burada.” Yardımcı olduğunda daha sonra tekrar kontrol etmek veya gönderi satıcı ya da taşıyıcı tarafından sağlanan beklenen teslimat süresini aştıysa destekle iletişime geçmek gibi bir sonraki adımı belirtin. Sisteminizin garanti edemeyeceği bir yenileme zamanı vadetmekten kaçının.

Zaman aşımına dayanıklı izleme akışı için yayına alma kontrol listesi

  • Her zaman aşımını hangi katmanın uyguladığını ve yeniden denemelerin hangi katmana ait olduğunu doğrulayın.
  • Toplam istek son tarihini ve ayrı, sınırlı bir yeniden deneme bütçesini belirleyin.
  • Otomatik olarak yeniden denenen işlemlerin tekrarlanmasının güvenli olduğunu doğrulayın.
  • Hız sınırlarına ve geçerli Retry-After talimatlarına uyun.
  • İstek sonucunu gönderi durumundan ve olay geçmişinden ayrı depolayın.
  • Geri dönüş verilerini etiketleyin ve mümkün olduğunda kaynağını ve zaman damgalarını koruyun.
  • Önbelleksiz, eski önbellekli, 429, 503, 504 ve geç yanıt senaryolarını test edin.
  • Bir zaman aşımının hatalı bir teslimat bildirimi tetikleyemeyeceğini veya doğrulanmış bir olayı silemeyeceğini kontrol edin.

Temel kural basittir: bir isteği yalnızca bunu yapmak güvenli ve yararlıysa yeniden deneyin; yalnızca tanımlayabildiğiniz bilgilere geri dönün ve hiçbir zaman bir HTTP zaman aşımından gönderi durumu çıkarımı yapmayın.

SSS

Zaman aşımına uğrayan bir izleme isteğini hemen yeniden denemeli miyim?

Otomatik olarak değil. İşlemin tekrarlanmasının güvenli olduğunu, genel son tarihin başka bir deneme için zaman bıraktığını ve herhangi bir hız sınırı talimatının beklemenizi gerektirmediğini kontrol edin. Salt okunur bir sorgu için jitter içeren kısa ve sınırlı bir yeniden deneme uygun olabilir; tekrarlanan anında yeniden denemeler iyi bir varsayılan değildir.

HTTP 504, taşıyıcının izleme sisteminin çalışmadığı anlamına mı gelir?

Hayır. Bu, bir ağ geçidinin veya proxy’nin üst düzey bir sistemden zamanında yanıt alamadığı anlamına gelir. Sorun bu istek yolu boyunca herhangi bir yerde olabilir. Taşıyıcının genel kullanılabilirliğini veya paketin durumunu ortaya koymaz.

Zaman aşımından sonra bilinen son durumu gösterebilir miyim?

Evet; bunu başarılı bir canlı yenileme yerine kullanılabilir en son bilgi olarak etiketlemeniz gerekir. Biliniyorsa olay zamanını ve alınma zamanını gösterin ve daha yeni bir güncellemenin doğrulanamadığını açıkça belirtin.

Zaman aşımı bir gönderiyi “taşımada” durumundan “istisna” durumuna değiştirmeli mi?

Hayır. Zaman aşımı bir istek hatasıdır, gönderi olayı değildir. Gönderi durumunu yalnızca güvenilir bir izleme kaynağı değişikliği destekleyen bir olay veya durum sağladığında değiştirin.

Zaman aşımına uğrayan istek bir izleme kaydı oluşturuyorsa veya kaydediyorsa ne olur?

Başarısız olduğunu varsaymayın. Yanıt kaybolmadan önce uzak sistem isteği işlemiş olabilir. İsteği yeniden göndermeden önce mevcut bir sonucu kontrol edin ve belgelenmiş bir idempotensi mekanizması veya sağlayıcı tarafından onaylanmış bir kurtarma prosedürü kullanın.

Kaynaklar