TotalApp Dökümanlar

Artifakt Kasası

Test hatalarında yakalanan ekran görüntülerini, videoları ve Playwright izlerini göz atın, oynatın ve yönetin.

Genel Bakış

Artifakt Kasası, test çalışmaları sırasında üretilen tüm hata kanıtlarının merkezi deposudur. Ekran görüntüleri, video kayıtları ve Playwright iz dosyaları, test başarısız olduğu anda veya yeniden deneme gerektirdiğinde otomatik olarak yakalanır ve burada saklanır.

Artık hata ayıklamak için CI loglarını karıştırmanız veya test ortamını yeniden oluşturmaya çalışmanız gerekmez — Artifakt Kasası, bir testin tam olarak nerede ve neden başarısız olduğunu görmenizi sağlar. Tam adım adım zamanlama dökümü için iz zaman çizelgesini kullanın.

Flake Takipçi ile Bağlantı

Flake Takipçi'de tutarsız bir test satırına tıkladığınızda Artifakt Kasası'na yönlendirilir ve o teste ait artifaktlar önceden filtrelenmiş olarak görüntülenir. İki ekran birlikte tespit → hata ayıklama akışını tamamlar.

Hızlı Başlangıç

1. Artifakt Kasası'nı Aç
2. Başarısız'a Filtrele
3. Artifakt Seç
4. Hata Ayıkla
  1. Artifakt Kasası'nı Açın — KG mod kenar çubuğundan Artifakt Kasası'nı tıklayın.
  2. Durum Filtresini Uygulayın — Yalnızca başarısız çalışmalar için Başarısız'ı veya tutarsız testler için Tutarsız'ı seçin.
  3. Bir Artifakt Seçin — Listedeki bir satırı tıklayarak sağ taraftaki görüntüleyiciye yükleyin.
  4. Sekme Seçin — Tam ekran görüntüsü için Görsel Hata Ayıklama, MP4 oynatma için Video Oynatıcı veya adım adım döküm için İz Zaman Çizelgesi'ni seçin.
  5. Saklama Süresini Yönetin — Varsayılanların üstünde tutulması gereken kritik kanıtlar için Saklama sekmesinden özel sona erme tarihleri belirleyin.

Üç Sekme

Görsel Hata Ayıklama

Başarısız test anında yakalanan PNG/WebP ekran görüntüsünü tam çözünürlükte görüntüleyin. Görüntüleyici şunları destekler:

  • Kaydırma için tıkla ve sürükle
  • Yakınlaştır/uzaklaştır
  • Gerçek boyut piksel boyutlarını gösteren meta veri şeridi
  • PNG veya orijinal WebP olarak indir

Video Oynatıcı

Eğer test koşucusu video kaydetmek üzere yapılandırılmışsa, başarısız test adımını çevreleyen tam MP4 klibini oynatın. Kontroller şunlardır:

  • Oynat / Duraklat / Belirli bir zaman damgasına atla
  • 0.5×'ten 2×'e oynatma hızı
  • Döngü modu (uzun animasyon gecikmeleri için kullanışlı)
  • Lokal MP4 olarak indir

İz Zaman Çizelgesi

Playwright `.zip` iz dosyasını milisaniye adım ayrıntı düzeyiyle adım adım oynatın. Her satır şunları gösterir:

  • Eylem türü (tıklama, doldurmak, bekleme, navigate)
  • Hedef seçici veya URL
  • Başarılı/Başarısız/Zaman Aşımı durumu
  • Süre (ms)
  • Söz konusu adım için ekran görüntüsü küçük resmi

İpucu: Tam adımı bulmak

Kırmızı satırlar (Başarısız veya Zaman Aşımı) testin neden durduğunu tam olarak gösterir. Adımı genişletin ve tam hata mesajını ve o andaki bağlam ekran görüntüsünü okuyun.

Varsayılan Saklama Politikaları

Artifakt TürüVarsayılan SaklamaÖzel Sona Erme
Ekran Görüntüleri (PNG/WebP) 30 gün Evet — dosya başına ayarlanabilir
Videolar (MP4) 14 gün Evet — dosya başına ayarlanabilir
Playwright İzleri (.zip) 7 gün Evet — dosya başına ayarlanabilir

Süre Dolan Artifaktlar Otomatik Silinir

Sona erme tarihine ulaşan artifaktlar otomatik olarak silinir. Önemli bir kanıtı daha uzun süre saklamanız gerekiyorsa, Saklama sekmesindeki Sona Ermesini Uzat seçeneğini kullanın veya dosyayı lokal olarak indirin.

Durum Filtreleri

Artifakt listesinin üstündeki filtre çubuğu şu durum kategorilerini destekler:

Geçti

Yeniden deneme gerektirmeden geçen testler. Bunların artifaktları referans karşılaştırma için saklanır.

Başarısız

Tüm denemelerde başarısız olan testler. Hata ayıklama için birincil hedef.

Tutarsız

Yeniden deneme sonrasında geçen testler. Flake Takipçi ile çakışır.

Atlandı

Atlanan veya beklemede olan test durumlarından gelen artifaktlar.

Depolama Yönetimi

Depolama kullanımı, sağ üst köşedeki Depolama Kullanımı sayacında görüntülenir. Bu sayaç şunları gösterir:

  • Kullanılan toplam GB ve bütçe sınırı
  • Türe göre dökümü (ekran görüntüleri / videolar / izler) gösteren yüzde çubuğu
  • Doluluk aşıldığında yeni artifaktların reddedileceğini belirten kırmızı uyarı rozeti

Depolamayı serbest bırakmak için şunları yapabilirsiniz:

Sık Sorulan Sorular

Artifaktlar otomatik olarak mı yakalanıyor?
Evet; Playwright veya uyumlu herhangi bir test koşucusu, her başarısız veya tutarsız test için otomatik olarak ekran görüntüsü ve iz yakalayacak şekilde yapılandırılabilir. Video yakalama isteğe bağlıdır (CI yapılandırmanızda etkinleştirin). Veriler TotalApp'e gönderildiğinde Artifakt Kasası'nda görünür.
Bir artıfaktı sildikten sonra kurtarabilir miyim?
Hayır. Silme işlemi geri alınamaz. Önemli kanıtları tutmak için sona erme tarihini uzatın veya dosyayı lokal olarak indirin.
İz zaman çizelgesi .zip dosyasını açabiliyor mu?
Evet. Playwright'in standart trace.zip formatını destekler. Başka bir iz formatından artifaktı görüntülemek istiyorsanız, önce onu Playwright iz formatına dönüştürün.
Depolama dolduğunda ne olur?
Yeni artifaktlar %100 dolulukta reddedilir. Arayüz bir uyarı gösterir. Mevcut artifaktları silmek veya varsayılan saklama politikalarını kısaltmak için Depolama Yönetimi araçlarını kullanın.