İçeriğe atla

Hata Kuyruğu, Yeniden İşleme ve Uzlaştırma

Ders 6 / 10 · 16 dakika okuma · İleri

Başarısız entegrasyon kayıtlarını logda görmek tek başına çözüm değildir. Hata tipi sınıflandırılmalı, otomatik yeniden deneme ile insan müdahalesi ayrılmalı ve iş sonucunun gerçek sistem durumuyla uyumlu olduğu doğrulanmalıdır. Uzlaştırma,

Bu Derste Öğrenecekleriniz

  • hata kuyruğu, yeniden i̇şleme ve uzlaştırma konusundaki temel karar ve kontrol noktalarını açıklayabilmek
  • hata kuyruğu, yeniden i̇şleme ve uzlaştırma için uygun bir uygulama veya kontrol adımı tasarlayabilmek

Hata Kuyruğu, Yeniden İşleme ve Uzlaştırma

Başarısız entegrasyon kayıtlarını logda görmek tek başına çözüm değildir. Hata tipi sınıflandırılmalı, otomatik yeniden deneme ile insan müdahalesi ayrılmalı ve iş sonucunun gerçek sistem durumuyla uyumlu olduğu doğrulanmalıdır. Uzlaştırma, sistemler arasında eksik veya çelişkili kayıtları bulmaya yarar.

Geçici ağ hataları artan aralıkla tekrar denenebilir; şema veya referans hataları veri düzeltilmeden tekrar denemeyle çözülmez. Dead-letter kuyruk veya hata listesinde özgün mesaj, hata nedeni, deneme sayısı ve düzeltme sahibi korunur. Yeniden işleme idempotent olmalıdır.

Konu İlişkilerini Kurmak

Hata Kuyruğu, Yeniden İşleme ve Uzlaştırma tek bir ekran veya belgeyle sınırlı değildir; kaynak sistem sahipliği, kimlik eşleştirme, API/olay/toplu aktarım seçimi, tekrar güvenliği, uzlaştırma ve operasyon takibini birlikte tasarlamak. Bu nedenle veri bir noktada doğru olsa da sonraki aşamada kaybolabilir veya farklı kuralla yorumlanabilir. Süreç tasarımında her kararın hangi kayda dayandığını, hangi koşulda duracağını ve hangi sonucun başarı sayılacağını açıkça belirleyin.

Uygulanabilir Kontrol Akışı

  • Kapsamı belirleyin: Hata Kuyruğu, Yeniden İşleme ve Uzlaştırma işleminde hangi müşteri, ürün, teklif, sipariş veya belge kaydının etkilendiğini yazın.
  • Kaynağı doğrulayın: ana veri sistemi, API günlükleri, olay kuyruğu, toplu dosya kayıtları, hata kuyruğu ve uzlaştırma raporu içinde kullanılan kaydın kimliğini ve son güncelleme zamanını kontrol edin.
  • Karar kuralını görünür yapın: mesajın gönderilmesi kadar işlenme sonucunu da izlemek; tekrarları güvenli yönetmek ve kaynak-hedef verisini uzlaştırmak.
  • İstisna yolunu tanımlayın: koşul karşılanmıyorsa kimin inceleyeceğini, işlemin nerede bekleyeceğini ve hangi kanıtın isteneceğini belirtin.
  • Sonucu ölçün: entegrasyon başarı oranı, veri gecikmesi, tekrar/çift kayıt sayısı, hata kapatma süresi ve uzlaştırma farkı değerini aynı kapsam ve dönem üzerinden karşılaştırın; düzeltme sahibini ve kontrol tarihini kaydedin.

Hata Kuyruğu, Yeniden İşleme ve Uzlaştırma için karar verirken önce iş hedefini ve kabul koşulunu belirleyin; sonra iş kimliği, sürüm, zaman damgası, işlem durumu, tekrar anahtarı, hata kodu ve yeniden işleme sonucu alanlarının doğru kayıttan geldiğini doğrulayın. mesajın gönderilmesi kadar işlenme sonucunu da izlemek; tekrarları güvenli yönetmek ve kaynak-hedef verisini uzlaştırmak. Bu kontrol, işlemi hızlandırırken sonradan düzeltme, yanlış taahhüt ve ekipler arası yorum farkı oluşmasını önler.

Örnek — İşletme senaryosu

ERP müşteriyi bulamadığı için sipariş mesajı reddedilir. Sorun müşteri eşlemesi düzeltilmeden aynı mesajı saatlerce tekrar göndermek çözüm değildir; önce referans verisi tamamlanır, sonra kontrollü yeniden işlenir.

Alternatif Senaryo ve Karar

Örnek

Karar senaryosu: Dosya aktarımı başarılı raporlanıyor fakat dosyanın bazı satırları hedef sistemde reddediliyor. Bu durumda doğru yaklaşım ilk kaydı olduğu gibi kabul etmek değil; iş kimliği, sürüm, zaman damgası, işlem durumu, tekrar anahtarı, hata kodu ve yeniden işleme sonucu alanlarını, iş kuralını ve işlem sahibini çapraz kontrol etmektir. Örneğin sonuç ile kaynak kayıt uyuşmuyorsa işlem tamamlandı kabul edilmemeli; uyuşmazlığın hangi adımda oluştuğu kaydedilmeli ve tekrar test edilmelidir.

Alternatifleri karşılaştırırken kısa vadeli işlem kolaylığı ile sonraki aşamalardaki maliyeti birlikte değerlendirin. Başarılı teknik yanıtı iş sürecinin tamamlandığı şeklinde yorumlamak veya sessiz veri kaybını fark etmemek. Kontrol adımını atlamanın sağlayacağı süre kazancı; hatalı kayıt, iade, itiraz, yeniden işleme veya müşteri güveni kaybı ile karşılaştırılmalıdır.

Alternatif durumda Dosya aktarımı başarılı raporlanıyor fakat dosyanın bazı satırları hedef sistemde reddediliyor. Bu örnekte ekip ilk görünen duruma göre karar vermek yerine ana veri sistemi, API günlükleri, olay kuyruğu, toplu dosya kayıtları, hata kuyruğu ve uzlaştırma raporu kayıtlarını karşılaştırmalı; eksik veri, yetki ve zamanlama farklarını ayrı ayrı işaretlemelidir. Koşullar doğrulanamıyorsa işlem durumu açıkça belirtilmeli ve sorumluya atanmalıdır.

Şimdi Uygulayın

Uygulama çalışması

Hata türlerini geçici, veri kaynaklı, kural ihlali ve kalıcı olarak ayırın; her biri için retry politikası, sahibi ve uzlaştırma kontrolü yazın.

Kanıt, Ölçüm ve Sahiplik

Kontrol noktasıKontrol sorusuKanıt / kayıt
Kaynak veriKararda kullanılan kayıt güncel ve doğru kimliğe bağlı mı?ana veri sistemi, API günlükleri, olay kuyruğu, toplu dosya kayıtları, hata kuyruğu ve uzlaştırma raporu
İş kuralıKoşul ve istisna açık biçimde tanımlanmış mı?mesajın gönderilmesi kadar işlenme sonucunu da izlemek; tekrarları güvenli yönetmek ve kaynak-hedef verisini uzlaştırmak
SorumlulukSorun oluştuğunda incelemeyi kim üstleniyor?İşlem sahibi, onaylayan ve hedef tarih
İş sonucuUygulama beklenen ticari/operasyonel etkiyi verdi mi?entegrasyon başarı oranı, veri gecikmesi, tekrar/çift kayıt sayısı, hata kapatma süresi ve uzlaştırma farkı

Hata Kuyruğu, Yeniden İşleme ve Uzlaştırma uygulamasının denetlenebilir çıktısı en az dört unsuru içermelidir: kullanılan kaynak kayıt, karar kuralı, sorumlu kişi ve sonuç kanıtı. iş kimliği, sürüm, zaman damgası, işlem durumu, tekrar anahtarı, hata kodu ve yeniden işleme sonucu alanlarından hangilerinin karar üzerinde etkili olduğu da yazılmalıdır. Bu kayıt, sonraki benzer işlemde aynı kontrolün tekrarlanmasını sağlar.

Uyarı — Kontrol noktası

Tüm başarısız mesajları otomatik ve sınırsız tekrar etmek sistem yükü ve yinelenen işlem riskini yükseltir.

Kontrol ve iyileştirme için entegrasyon başarı oranı, veri gecikmesi, tekrar/çift kayıt sayısı, hata kapatma süresi ve uzlaştırma farkı göstergelerini başlangıç seviyesiyle karşılaştırın. Fark çıktığında önce veri tanımının değişip değişmediğini, ardından süreç kaynaklı nedeni inceleyin. Düzeltme için sahip, hedef tarih ve tekrar ölçüm koşulu atayın; yalnızca faaliyetin tamamlanmasını başarı saymayın.

Bu Derste Ne Öğrendik?

  • Bu derste hata kuyruğu, yeniden i̇şleme ve uzlaştırma konusunun temel iş mantığını, karar ölçütlerini, gerçekçi bir iş senaryosunu ve uygulamada kontrol edilmesi gereken riski ele aldınız.
  • Bir sonraki adım, bu yaklaşımı kendi ürün, müşteri ve süreç verilerinizle sınamaktır.

Öğrendiklerinizi Projenize Dönüştürün

Pazaryeri, online mağaza veya kurumsal dijital ticaret projeniz için KMK'nın deneyimli ekibiyle ihtiyaçlarınızı değerlendirin.