Real vaxtda izləmə sorğusunun vaxtı bitdi? Yenidən cəhd, ehtiyat variant və status qaydaları
Real vaxt rejimində izləmə sorğusunun vaxtı bitdikdə, göndərişin ən son statusunu gecikmiş, itmiş və ya dəyişməmiş kimi deyil, naməlum kimi qəbul edin. Yalnız məhdud vaxt büdcəsi çərçivəsində yenidən cəhd edin, sonra aydın şəkildə etiketlənmiş son məlum yeniləməni göstərin və ya istifadəçidən daha sonra yenidən yoxlamağı xahiş edin. Bütün proses ərzində sorğunun nəticəsini, məlumatların yeniliyini və bağlamanın faktiki statusunu bir-birindən ayrı saxlayın.
Bu fərq həm müştərilərə göstərilən izləmə səhifələri, həm də bildirişləri və ya dəstək iş axınlarını işə salmaq üçün izləmə məlumatlarından istifadə edən sistemlər üçün vacibdir. Vaxtın bitməsi cavabın vaxtında gəlmədiyini bildirir. Bu, daşıyıcının yeni hadisəyə sahib olub-olmadığını, yuxarı səviyyəli xidmətin sorğunu emal edib-etmədiyini və ya bağlamanın hərəkət edib-etmədiyini göstərmir.
Əvvəlcə nəyin vaxtının bitdiyini müəyyən edin
İzləmə sorğusu bir neçə mərhələdə uğursuz ola bilər: brauzer tətbiqinizi gözləməyi dayandıra, tətbiqiniz izləmə API-sini gözləməyi dayandıra və ya həmin API başqa xidmətlə əlaqə saxlayarkən vaxtı bitə bilər. İstifadəçi hər bir halda eyni ümumi xətanı görə bilər, lakin uyğun növbəti əməl fərqli olur.
- Müştəri tərəfində vaxt aşımı: Tətbiq gözləməyi dayandırıb. Server tərəfindəki sorğu hələ də tamamlanmış ola bilər. Başqa bir sorğu göndərməzdən əvvəl öz sorğu jurnallarınızı və ya nəticə anbarınızı yoxlayın; belə sorğu işi təkrarlaya bilər.
- Şəbəkə və ya bağlantı xətası: Sisteminiz istifadə edilə bilən cavab almayıb. Uzaq xidmətin sorğunu emal edib-etmədiyini bilməyə bilərsiniz.
- HTTP 504: Şlüz və ya proksi yuxarı səviyyəli serverdən vaxtında cavab almayıb. Bu, göndərişi deyil, sorğunun keçdiyi yolu təsvir edir.
- HTTP 408: Server gözləməyə hazır olduğu müddət ərzində tam sorğu mesajı almayıb. Bu, daşıyıcının izləmə statusu deyil.
- Köhnə hadisə ilə HTTP 200: Sorğu uğurlu olub, lakin qaytarılan izləmə məlumatı hələ də köhnəlmiş ola bilər. Uğurlu HTTP cavabı məlumatın yeniliyinə zəmanət vermir.
Bu nəticələri sorğu diaqnostikası kimi qeyd edin. Onların heç birini “daşınır”, “istisna” və ya “çatdırılıb” kimi göndəriş etiketlərinə çevirməyin. Bu etiketlər nəqliyyat qatından deyil, izləmə hadisələrindən və ya sənədləşdirilmiş status sahəsindən gəlməlidir.
Açıq-uclu dövrə deyil, məhdudlaşdırılmış yenidən cəhddən istifadə edin
Yalnız oxuma məqsədli izləmə sorğusu üçün vaxt aşımından sonra yenidən cəhd etmək çox vaxt məqsədəuyğundur. Bununla belə, cəhd məhdud olmalıdır. Təkrarlanan sorğular çətinlik yaşayan xidmətin yükünü artıra, istifadəçinin gözləmə müddətini uzada və bir neçə tətbiq qatı müstəqil şəkildə yenidən cəhd etdikdə işi təkrarlaya bilər.
- Ümumi son tarix təyin edin. İlkin cəhd və istənilən yenidən cəhdi nəzərə alaraq, istifadəçiyə göstərilən əməliyyatın nə qədər davam edə biləcəyinə qərar verin. Hər cəhd üçün zəng edən tərəfin gözləyə biləcəyi müddəti aşan yeni, tam son tarix verməyin.
- Əməliyyatın təkrarlanmasının təhlükəsiz olub-olmadığını yoxlayın. Axtarış adətən göndərişi qeydiyyata alan, parametrləri dəyişən və ya resurs yaradan sorğudan fərqlənir. Təchizatçının müqaviləsi və ya idempotentlik nəzarətləriniz bunu təhlükəsiz etmədikcə, vəziyyəti dəyişən sorğunu avtomatik təkrar göndərməyin.
- Keçici xətanı qənaətlə təkrarlayın. Kiçik, açıq şəkildə müəyyən edilmiş yenidən cəhd büdcəsindən və bir çox müştəridən eyni vaxtda dərhal cəhdlər göndərmək əvəzinə, jitter ilə gecikmədən istifadə edin.
- Tətbiq olunan server təlimatlarına əməl edin. Cavabda etibarlı
Retry-Afterbaşlığı varsa, daha erkən yenidən cəhd planlaşdırmayın. Həmçinin daha sərt tətbiq və ya təchizatçıya xas məhdudiyyətlərə riayət edin. - Son tarix və ya büdcə tükəndikdə dayanın. Alternativ cavaba keçin və iş axınınız tələb edirsə, sonrakı uyğunlaşdırmanı ayrıca planlaşdırın.
Praktik dizayn kifayət qədər vaxt qaldıqda istifadəçiyə göstərilən bir yenidən cəhdə icazə verə, əlavə cəhdləri isə arxa fonda yeniləməyə keçirə bilər. Bu, universal API qaydası deyil, siyasət nümunəsidir. Məhdudiyyətləri xidmət səviyyəsi məqsədlərinizə, müşahidə olunan gecikməyə və təchizatçının sənədlərinə əsasən seçin. HTTP kitabxanaları, şlüzlər və tapşırıq işçiləri tərəfindən edilən cəhdləri də sayın; əks halda zahirən mülayim tətbiq siyasəti yuxarı səviyyəli xidmətlərə çoxsaylı çağırışlar yarada bilər.
HTTP 429 üçün cavabı dərhal yenidən cəhd etmək səbəbi deyil, sürət limiti siqnalı kimi qəbul edin. HTTP 503 sorğunu müvəqqəti emal edə bilməməyi göstərə bilər və server Retry-After təqdim edə bilər. 504 keçici ola bilər, lakin növbəti cəhdin işləyəcəyinə zəmanət vermir. Autentifikasiya xətaları ümumiyyətlə məlumat və ya icazə yoxlamasını, səhv formalaşdırılmış sorğular isə giriş məlumatlarının düzəldilməsini tələb edir. “Tapılmadı” nəticəsi verən izləmə identifikatoruna daha diqqətlə yanaşmaq lazımdır: təchizatçının sənədləşdirilmiş davranışından və göndərişin mərhələsindən asılı olaraq, qeyd tapmaq üçün hələ tez ola bilər və ya identifikator səhv ola bilər. Belə bir nəticəni bağlamanın mövcud olmadığı barədə qəti iddiaya çevirməyin.
Bildiklərinizi qoruyan alternativ seçin
Ən təhlükəsiz alternativ adətən öz hadisə vaxtı və dürüst yenilik etiketi ilə birlikdə son təsdiqlənmiş izləmə nəticəsidir. Bu nəticəni cari sorğu xətasından ayrı saxlayın. Səhifə belə deyə bilər: “Mövcud olan ən son yeniləmə: Müəssisədən ayrılıb. Son yoxlama: [vaxt]. Daha yeni yeniləmə müvəqqəti olaraq əlçatan deyil.” “Son yoxlama”nı yalnız sisteminiz bunu həqiqətən qeyd edirsə daxil edin; bu, daşıyıcının hadisə vaxtını əvəz etmir.
Dəstəkləyə bildiyiniz ən dəqiq vaxtdan istifadə edin. Daşıyıcının hadisə vaxtı hadisənin bildirildiyi zaman baş verdiyini göstərir. Sisteminizin həmin hadisəni aldığı vaxt qəbul edilməni göstərir. İstifadəçinin səhifəni açdığı vaxt isə bunların heç birini göstərmir. Mənbə etibarlı hadisə vaxtı və ya saat qurşağı təqdim etmirsə, vaxt uydurmayın. Eynilə, keşlənmiş nəticənin qeydə alınmış əldə edilmə vaxtı yoxdursa, onun bu yaxınlarda yeniləndiyini iddia etmək əvəzinə “son mövcud yeniləmə” adlandırın.
Alternativ üç sərhədə əməl etməlidir:
- Keşlənmiş məlumatı keşlənmiş məlumat kimi göstərin. Köhnə hadisəni vaxtı bitmiş sorğunun nəticəsi kimi təqdim etməyin.
- Keçən müddətə əsasən irəliləyiş çıxarmayın. Bağlama bir neçə gündür daşınır deyə avtomatik olaraq “çatdırılma üçün çıxıb” sayılmır.
- Əhəmiyyətli qeyri-müəyyənliyi gizlətməyin. Əvvəlki nəticə yoxdursa, uydurma standart status göstərmək əvəzinə izləmənin müvəqqəti əlçatmaz olduğunu bildirin.
Digər alternativ yollarına əvvəllər sinxronlaşdırılmış izləmə anbarı, səlahiyyətli daşıyıcı axtarışı və ya sonrakı arxa plan yeniləməsi daxil ola bilər. Onlardan yalnız göndərişə, icazələrinizə və məlumat mənbəyinin şərtlərinə uyğun olduqda istifadə edin. İkinci mənbədə fərqli hadisə adları və ya hesabat gecikmələri ola bilər; buna görə mənşə məlumatını qoruyun və bunu etmək üçün qayda olmadan ziddiyyətli qeydləri birləşdirməyin. Müştəri nəticə əsasında hərəkət edə bilirsə, sonsuz yükləmə göstəricisi saxlamaq əvəzinə yenidən cəhd etmək və ya dəstəklə əlaqə saxlamaq imkanı verin.
Sorğu statusunu, məlumatların yeniliyini və göndəriş statusunu ayrı saxlayın
Bunlar istifadəçi interfeysində birlikdə göstərilsə belə, üç fərqli sahədir. Sorğu statusu axtarışın uğurlu olub-olmadığını, vaxtının bitdiyini və ya xəta aldığını bildirir. Məlumatların yeniliyi qaytarılmış və ya saxlanmış məlumatın nə vaxt müşahidə edildiyini bildirir. Göndəriş statusu izləmə mənbəyinin bağlama haqqında nə bildirdiyini göstərir. Onları ayırmaq müvəqqəti API xətasının etibarlı çatdırılma hadisəsini silməsinin və ya köhnə daşınma hadisəsini cari iddiaya çevirməsinin qarşısını alır.
Məsələn, sistem əvvəlki axtarışdan təsdiqlənmiş “Çatdırılıb” hadisəsini saxlaya bilər, cari yeniləmə isə vaxt aşımına uğraya bilər. Çatdırılma hadisəsi yoxa çıxmır. Düzgün birləşdirilmiş vəziyyət ondan ibarətdir ki, son mövcud göndəriş statusu çatdırılıb və ən son yeniləmə uğursuz olub. Əksinə, son hadisə “Daşınır”dırsa, vaxt aşımı bağlamanın hazırda da daşınmaqda olduğunu təsdiqləmir; yalnız daha yeni cavabın əldə edilmədiyini təsdiqləyir.
Hadisələr sıra pozuntusu ilə gəldikdə müəyyən edilmiş qaydanı tətbiq edin. Mövcud olduqda hadisə identifikatorlarını, vaxt möhürlərini, mənbəni və təchizatçının sənədləşdirilmiş status semantikasını müqayisə edin. Sisteminizin yeniləmələri qəbul etdiyi ardıcıllığın göndəriş hadisələrinin baş verdiyi ardıcıllıq olduğunu düşünməyin. Gecikmiş köhnə hadisə də avtomatik olaraq daha yeni təsdiqlənmiş statusu əvəz etməməlidir. Bununla belə, düzəlişlər və istisnalar qanuni ola bilər; buna görə çatdırılmadan sonrakı status dəyişikliklərini qeyri-mümkün hesab edən ümumi qaydadan qaçın. Əsas hadisələri qoruyun və ziddiyyətləri tarixi səssizcə yenidən yazmadan araşdırın.
Təchizatçı HTTP 202 qaytarırsa, onu həmin son nöqtənin müqaviləsinə uyğun şərh edin: sorğunun qəbul edilməsi özlüyündə izləmə axtarışının tamamlandığı demək deyil. Eynilə, HTTP 200 həmin son nöqtənin semantikasına əsasən HTTP sorğusunun uğurlu olduğunu təsdiqləyir; bu, hər bir izləmə sahəsinin mövcud və ya aktual olduğunu sübut etmir. Təchizatçıya xas cavab sahələrini yalnız təchizatçının sənədlərini yoxladıqdan sonra uyğunlaşdırın.
Müştəriləri narahat etmədən xətanı operatorlar üçün görünən edin
Faydalı əməliyyat qeydinə sorğu identifikatoru, son nöqtə və ya əməliyyat, cəhd sayı, keçən vaxt, vaxt aşımının qatı, qəbul edilibsə HTTP statusu və cavabın canlı axtarışdan, yoxsa alternativdən gəlib-gəlmədiyi daxil olur. İzləmə məlumatları üçün mənbəni və müvafiq hadisə və ya əldə edilmə vaxt möhürlərini qeyd edin. İzləmə nömrələrini və müştəri məlumatlarını təşkilatınızın giriş və saxlanma qaydalarına uyğun idarə edin; diaqnostik faydalılıq məhdudiyyətsiz jurnallarda tam identifikatorları açıqlamaq üçün səbəb deyil.
Tək bir vaxt aşımına əsaslanmaq əvəzinə nümunələri izləyin. Bir daşıyıcı marşrutunda artan vaxt aşımı dərəcəsi, təkrarlanan 429 cavabları və ya daşıyıcının hadisə vaxtı ilə əldə edilmə vaxtı arasındakı artan fərq müxtəlif problemlərə işarə edə bilər. Birinci hal təchizatçının araşdırılmasını, ikinci hal sürətə nəzarəti, üçüncü hal isə sinxronizasiyanın və ya hadisə çatdırılmasının yoxlanmasını tələb edə bilər. Tətbiq izləməni 17TRACK Tracking API kimi təchizatçı vasitəsilə təqdim edirsə, bu ümumi qaydaları tətbiq etməzdən əvvəl son nöqtəyə xas cavab sahələrini, sorğu limitlərini və xəta idarəetməsini yoxlamaq üçün həmin təchizatçının sənədlərindən istifadə edin.
Müştəriyə göstərilən mesaj dəqiq və təmkinli olmalıdır: “İzləməni hazırda yeniləyə bilmədik. Mövcud olan ən son yeniləmə budur.” Faydalı olduqda növbəti addımı göstərin; məsələn, daha sonra yenidən yoxlamağı və ya göndəriş satıcı və ya daşıyıcı tərəfindən verilmiş gözlənilən çatdırılma müddətini keçibsə, dəstəklə əlaqə saxlamağı təklif edin. Sisteminizin zəmanət verə bilmədiyi yenilənmə vaxtını vəd etməkdən çəkinin.
Vaxt aşımına davamlı izləmə axını üçün buraxılış yoxlama siyahısı
- Hər vaxt aşımını hansı qatın tətbiq etdiyini və yenidən cəhdlərə hansı qatın sahib olduğunu təsdiqləyin.
- Ümumi sorğu son tarixini və ayrıca, məhdudlaşdırılmış yenidən cəhd büdcəsini təyin edin.
- Avtomatik yenidən cəhd edilən əməliyyatların təkrarlanmasının təhlükəsiz olduğunu yoxlayın.
- Sürət limitlərinə və etibarlı
Retry-Aftertəlimatlarına əməl edin. - Sorğunun nəticəsini göndəriş statusundan və hadisə tarixçəsindən ayrı saxlayın.
- Alternativ məlumatlarını etiketləyin və mövcud olduqda mənbəyini və vaxt möhürlərini qoruyun.
- Keşsiz, köhnə keşli, 429, 503, 504 və gec cavab ssenarilərini yoxlayın.
- Vaxt aşımının səhv çatdırılma bildirişini işə sala və ya təsdiqlənmiş hadisəni silə bilmədiyini yoxlayın.
Əsas qayda sadədir: sorğunu yalnız bunu etmək təhlükəsiz və faydalı olduqda yenidən göndərin; yalnız müəyyən edə bildiyiniz məlumatlara alternativ kimi keçin; və heç vaxt HTTP vaxt aşımından göndəriş statusu barədə iddia irəli sürməyin.
FAQ
Vaxtı bitmiş izləmə sorğusunu dərhal yenidən göndərməliyəm?
Avtomatik olaraq yox. Əməliyyatın təkrarlanmasının təhlükəsiz olduğunu, ümumi son tarixin başqa cəhd üçün vaxt saxladığını və heç bir sürət limiti təlimatının gözləməyi tələb etmədiyini yoxlayın. Yalnız oxuma məqsədli axtarış üçün jitter ilə qısa, məhdudlaşdırılmış yenidən cəhd uyğun ola bilər; təkrarlanan dərhal cəhdlər yaxşı standart seçim deyil.
HTTP 504 daşıyıcının izləmə sisteminin işləmədiyi deməkdir?
Xeyr. Bu, şlüz və ya proksinin yuxarı səviyyəli xidmətdən vaxtında cavab almadığını bildirir. Problem həmin sorğu yolu boyunca istənilən yerdə ola bilər. Bu, daşıyıcının ümumi əlçatanlığını və ya bağlamanın vəziyyətini müəyyən etmir.
Vaxt aşımından sonra son məlum statusu göstərə bilərəm?
Bəli, onu uğurlu canlı yeniləmə kimi deyil, mövcud olan ən son məlumat kimi etiketləsəniz. Məlum olduqda hadisə vaxtını və əldə edilmə vaxtını göstərin və daha yeni yeniləmənin təsdiqlənə bilmədiyini aydınlaşdırın.
Vaxt aşımı göndərişi “daşınır” statusundan “istisna” statusuna dəyişməlidirmi?
Xeyr. Vaxt aşımı göndəriş hadisəsi deyil, sorğu xətasıdır. Göndəriş statusunu yalnız etibarlı izləmə mənbəyi dəyişikliyi dəstəkləyən hadisə və ya status təqdim etdikdə dəyişin.
Vaxtı bitmiş sorğu izləmə qeydi yaradır və ya qeydiyyata alırdısa nə etməliyəm?
Onun uğursuz olduğunu düşünməyin. Cavab itirilməzdən əvvəl uzaq sistem onu emal etmiş ola bilər. Yenidən göndərməzdən əvvəl mövcud nəticəni yoxlayın və sənədləşdirilmiş idempotentlik mexanizmindən və ya təchizatçı tərəfindən təsdiqlənmiş bərpa prosedurundan istifadə edin.
Mənbələr
- RFC 9110, HTTP Semantikası — HTTP statuslarının tərifləri,
Retry-Aftervə sorğuların yenidən göndərilməsi ilə bağlı mülahizələr. - RFC 6585, Əlavə HTTP Status Kodları — HTTP 429-un tərifi və onun
Retry-Afterilə istifadəsi. - Amazon Builders’ Library, “Vaxt aşımı, yenidən cəhdlər və jitter ilə geri çəkilmə” — yenidən cəhdlərin güclənməsi, geri çəkilmə və jitter üzrə mühəndislik təlimatı.
- 17TRACK Tracking API sənədləri — tətbiqdən əvvəl təchizatçıya xas API davranışını yoxlamaq üçün istinad.


