8071 ürünün 6700’üncü kaydında duran bir aktarımda yalnız son satırı bilmek sorunu çözmez. Kaynağın indirildiği an, iş sürümü, işlenen ürün anahtarı ve hata sınıfı kaydedilmediyse aynı işlemin körlemesine tekrarı mükerrer veya eksik güncellemeye yol açabilir.
Çalışma ve ürün loglarını ayırın
| Log | Temel alanlar | Kullanım |
|---|---|---|
| Run log | run_id, source_id, zaman, durum, sayaçlar | İşin genel sonucu |
| Item log | run_id, source_key, product_id, aşama, sonuç | Ürün bazlı izleme |
| Error log | error_code, sınıf, güvenli mesaj, retryable | Sorun sınıflandırma |
| Checkpoint | cursor/page/offset, son başarılı anahtar | Yarıda kalan işi sürdürme |
| Quarantine | ham kayıt özeti, neden, karar durumu | Manuel inceleme |
Hataları yeniden denenebilirliğe göre sınıflandırın
- Geçici: zaman aşımı, 429, bazı 5xx yanıtları; sınırlı retry olabilir.
- Kalıcı veri hatası: geçersiz barkod, eksik zorunlu fiyat, tanımsız kategori; karantina gerekir.
- Kimlik çakışması: aynı SKU iki ürün; otomatik retry değil insan kararı gerekir.
- Sistem hatası: şema değişikliği, veritabanı kesintisi; işi durdurup alarm üretin.
- İş kuralı reddi: aşırı düşük fiyat, stok belirsizliği; nedeni raporlayıp satışa açmayın.
Artan aralıklı yeniden deneme
Geçici hata için hemen arka arkaya yüzlerce istek göndermek kaynağın korumasını daha da tetikleyebilir. Örneğin 1, 5 ve 15 dakikalık sınırlı deneme penceresi kullanılabilir; asıl değerler sağlayıcının limitine göre belirlenir. Retry sayacı run ve ürün kaydında tutulur.
HTTP 429 yanıtındaki Retry-After bilgisi varsa dikkate alınmalıdır. Başarılı olmayan her deneme sonsuza kadar kuyruğa dönmemeli; üst sınırdan sonra alarm ve manuel inceleme gerekir.
Güvenli loglama ve performans
XML aktarımında sık yapılan hatalar iş kuralı örneklerini, güvenli senkronizasyon aralığı zamanlama tarafını açıklar.
- XML’in tamamını her hata satırına kopyalamayın; kaynak anahtarı ve sınırlı özet tutun.
- Şifre, token, veritabanı parolası ve müşteri verisini loglamayın.
- Aynı hatayı toplulaştırıp adet ve ilk/son görülme zamanı saklayın.
- Log tablolarına source_id, run_id, status ve date_added indeksleri ekleyin.
- Saklama süresi belirleyin; eski ayrıntıyı özet rapora dönüştürün.
Operasyon ekranında gösterilecek özet
Petedor XML üyelik ve entegrasyon desteği için pet shop XML bayilik sayfasını inceleyebilirsiniz.
- Son başarılı çalışma ve kaynak verisinin yaşı.
- İşlenen, güncellenen, yeni, kapatılan, atlanan ve hatalı adet.
- En sık hata kodları ve etkilenen ürün sayısı.
- Retry bekleyen ve karantinadaki kayıt sayısı.
- Bir önceki çalışmaya göre olağan dışı ürün/stok/fiyat değişimi.
- İş süresi ve ürün başına ortalama işlem süresi.
Karar özeti
Run ve ürün loglarını ayırın, hataları geçici/kalıcı/çakışma/sistem olarak sınıflandırın. Yalnız geçici hatayı sınırlı artan aralıkla tekrar deneyin; doğrulama ve kimlik sorunlarını karantinaya alın.
Sık sorulan sorular
XML logunda ham ürünün tamamı tutulmalı mı?
Genellikle gerekmez. Kaynak anahtarı, kritik alan özeti ve dosya/çalışma referansı yeterlidir. Hassas veri ve token loglanmamalıdır.
Hangi hatalar otomatik yeniden denenir?
Zaman aşımı, 429 ve bazı geçici 5xx yanıtları sınırlı retry alabilir. Geçersiz veri ve kimlik çakışması otomatik tekrarlanmamalıdır.
Aktarım kaldığı yerden nasıl devam eder?
Sayfa/offset veya son başarılı kararlı ürün anahtarı checkpoint olarak saklanır. İşlemler idempotent olmalıdır; aynı ürün tekrar işlense de ikinci kayıt açılmamalıdır.
Loglar ne kadar süre saklanır?
İşletmenin denetim, hata çözme ve depolama ihtiyacına göre politika belirlenir. Eski ayrıntı özetlenebilir; yasal ve güvenlik gereksinimleri dikkate alınır.
Her ürün için log performansı düşürür mü?
Aşırı ayrıntı düşürebilir. Toplu yazma, uygun indeks, sınırlı alan ve aynı hatayı toplulaştırma yaklaşımı kullanılmalıdır.