İçeriğe geç

Kayda basmadan önceki hatalar dahil, konsol loglarını da kaydeden ekran kaydedici

Güncelleme

Midge, konsol loglarını da kaydeden bir ekran kaydedici. Chrome'da ekranını kaydederken ya da ekran görüntüsü alırken, sayfanın ürettiği her konsol mesajını, console.log'dan yakalanmamış hatalara ve işlenmemiş promise reddedilmelerine kadar, stack trace'leriyle birlikte yakalar ve videoyla hizalar. Midge son konsol çıktısını sürekli yenilenen bir tamponda tuttuğu için, kayda basmadan önce oluşan bir hata da raporda yer alır.

Bug raporlarının çoğunun kaçırdığı şey bu ikinci kısım. Bir şeyin bozulduğunu fark ettiğinde hata, kimsenin açmadığı bir DevTools penceresinde çoktan kayıp gitmiştir. Midge, “konsol açıkken bir daha dener misin?” adımını ortadan kaldırır.

Neler yakalanır

Tüm konsol seviyeleri

Midge log, info, warn, error ve debug çağrılarını zaman damgaları ve kendilerine verilen değerlerle kaydeder. Uyarılar sanıldığından daha önemlidir: bir çökmeden hemen önce loglanan bir React key uyarısı ya da bir kullanımdan kaldırma bildirimi çoğu zaman asıl ipucudur.

Yakalanmamış hatalar

Kimsenin yakalamadığı hatalar asla console.error'dan geçmez. Pencereye kadar yükselirler ve tarayıcı onları kırmızıyla yazar. Midge bunları da dinler; böylece uygulamanda hiç loglama olmasa bile bir event handler'daki çökme raporda görünür.

İşlenmemiş promise reddedilmeleri

.catch() olmadan reddedilen bir promise, modern front end'lerdeki en yaygın sessiz hatalardan biri. Bir fetch reddedildiği ve kimse bunu ele almadığı için bir düğme “hiçbir şey yapmaz”. Midge bu reddedilmeleri ve taşıdıkları nedeni kaydeder.

Stack trace'ler

Hatalar için Midge, tarayıcının bildirdiği stack trace'i kaydeder. Tipik bir kayıt şöyle görünür:

Uncaught (in promise) TypeError: Failed to fetch
    at submitOrder (orders.js:88:15)
    at HTMLButtonElement.onClick (checkout.js:41:9)

Production bundle'ın minify edilmişse, stack tam tarayıcının bildirdiği gibi minify edilmiş dosya adlarını ve konumları gösterir; bu yüzden production'dan gelen bir raporu okurken source map'lerini yakında tut.

Kayda basmadan önce yakalanır

Midge her sayfa yüklenmeye başlarken, uygulamanın kendi script'leri çalışmadan önce dinlemeye başlar; böylece açılış sırasında fırlatılan hatalar bile yakalanır. Açık her sekme için konsol çıktısının son birkaç dakikasını bellekte tutar.

Bir ekran kaydı başlattığında ya da bir ekran görüntüsü aldığında bu yakın geçmiş eklenir. Pratikte bu şu demek: normal şekilde çalışırsın, bir şeyin yanlış göründüğünü fark edersin ve ancak o zaman raporlamaya karar verirsin. 20 saniye önceki kırmızı hata hâlâ zaman çizelgesindedir.

Tamponla ilgili birkaç not:

  • Yalnızca bellekte yaşar ve sekme kapandığında temizlenir.
  • Sen bir rapor oluşturmadıkça hiçbir şey bilgisayarından çıkmaz.
  • Normal http ve https sayfalarında çalışır. Bankan ya da şifre yöneticin gibi Midge'in hiç çalışmaması gereken siteleri ekleyebilirsin.

Konsol ve video tek bir zaman çizelgesinde

Her kayıtta konsol logları, ağ istekleri, kullanıcı adımları ve cihaz bilgileri var. Raporda konsol, zamana göre sıralanmış şekilde videonun yanında durur. Modal'ın açılamadığı anı izlersin ve eşleşen TypeError hemen oradadır, onu tetikleyen tıklamanın birkaç satır altında.

Hatalar ağ etkinliğiyle doğal olarak eşleşir. /api/orders'tan dönen bir 500 ve ardından gelen Cannot read properties of undefined bütün hikâyeyi anlatır: sunucu başarısız oldu ve istemci bu hatayı ele almadı. Daha fazlası için ağ logları sayfasına bak.

Konsol çıktısındaki gizli bilgiler

Geliştiriciler, özellikle hata ayıklarken, loglamamaları gereken şeyleri loglar: bir token, bir kullanıcı nesnesinin tamamı, query string'inde API anahtarı olan bir istek URL'si. Midge, ağ verileri için kullandığı maskeleme kurallarını konsol metnine de uygular. Şifreler, kart numaraları, token'lar ve çerezler, hiçbir şey cihazından çıkmadan önce tarayıcında maskelenir.

Örneğin şu satır:

auth ok: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI0MiJ9.abc123 for [email protected]

raporda şöyle görünür:

auth ok: [REDACTED] for j***@acme.com

Kuralların tam listesi ve maskelemenin neleri yakalamadığı maskeleme sayfasında.

Midge ile konsolu elle dışa aktarmak arasındaki fark

Konsol çıktısını Chrome DevTools'tan kendin de kaydedebilirsin; Chrome'da konsol logları nasıl dışa aktarılır rehberimiz bunu adım adım anlatıyor. İşe yarar, ama eksikleri var. DevTools hata olmadan önce açık olmalı, dışa aktarılan dosya videosuz düz metindir ve içindeki gizli bilgileri hiçbir şey temizlemez. Logları ya da bir HAR dosyasını elle dışa aktarıyorsan, HAR'ı bir ticket'a eklemeden önce ücretsiz HAR temizleyiciden geçir.

Midge ile konsol, DevTools açık olsun ya da olmasın yakalanır, gördüklerinle senkronize olur ve yüklemeden önce maskelenir.

Bu logları kimler okur

QA tester'lar ticket'lara yarım stack trace yapıştırmayı bırakır. Destek ekibi, konsolun ne olduğunu bilmeden bir eskalasyona gerçek hata çıktısını ekleyebilir. Geliştiriciler tam hatayı, stack'i ve çevresindeki ağ çağrılarını tek bir yerde görür. Rolün buysa geliştiriciler için Midge sayfasına bak.

Midge ücretsiz: sınırsız kayıt, 15 dakikaya kadar video ve filigran yok.

Sık sorulan sorular

Midge hangi konsol mesajlarını yakalıyor?
Beş seviyenin hepsini: log, info, warn, error ve debug. Ayrıca console.error'dan hiç geçmeyen yakalanmamış hataları ve işlenmemiş promise reddedilmelerini de stack trace'leriyle birlikte kaydeder.
Midge, kayda başlamadan önce olan bir hatayı yakalayabilir mi?
Evet. Midge her sekme için konsol çıktısının son birkaç dakikasını bellekte tutar; böylece bir hatanın hemen ardından yaptığın kayıt ya da aldığın ekran görüntüsü o hatayı da içerir. Tampon sekmeyi kapattığında temizlenir ve sen bir rapor oluşturmadıkça cihazından asla çıkmaz.
Konsol mesajlarındaki gizli bilgiler maskeleniyor mu?
Evet. JWT'ler, kart numaraları, bilinen API anahtarı formatları, özel anahtarlar ve hassas URL parametreleri konsol metninden silinir; e-postalar ve uluslararası telefon numaraları yarı maskelenir.
DevTools'u açmam gerekiyor mu?
Hayır. Midge konsolu DevTools açık olmadan yakalar ve raporunu açan kişi mesajları videonun yanında görür.