Her bug raporuyla birlikte yakalanan Chrome ağ logları
Güncelleme
Midge her bug raporuyla birlikte Chrome ağ loglarını otomatik olarak yakalar. Fetch ve XHR istekleri header'ları, istek ve yanıt body'leri, durum kodları ve süreleriyle gelir; WebSocket mesajları gönderilip alındıkları anda kaydedilir; script'ler, stiller, görseller ve fontlar durum, boyut ve süreleriyle listelenir. Bir geliştirici herhangi bir isteği açabilir, onu cURL olarak kopyalayabilir ya da logun tamamını maskelenmiş bir HAR dosyası olarak indirebilir.
DevTools'u açman gerekmez; bug'ı bildiren kişinin HAR dosyasının ne olduğunu bilmesi de gerekmez. Her kayıtta konsol logları, ağ istekleri, kullanıcı adımları ve cihaz bilgileri var.
DevTools ağ paneli neden yetmez
Hata ayıklayan sen olduğunda Chrome'un Network paneli mükemmeldir. Bug raporları içinse üç sorunu var:
- İstek olmadan önce açık olmalı. DevTools'u açmadan önce yapılan istekler orada yoktur ve çoğu insan onu bug'dan sonra açar.
- Sayfa değişince temizlenir; tabii biri “Preserve log” kutusunu işaretlemeyi hatırlamadıysa.
- HAR dışa aktarımı gizli bilgiler içerir. Çerezler,
Authorizationheader'ları ve query string'lerdeki token'lar dosyaya girer. HAR dosyasından hassas veriler nasıl silinir rehberimiz bunun neden önemli olduğunu anlatıyor.
Midge her sayfada ağ etkinliğini arka planda yakalar, son istekleri bellekte tutar ve bir rapor oluşturduğunda onları ekler. Gizli bilgiler yüklemeden önce silinir.
Bir istek raporda nasıl görünür
Her istek, video ve konsolla aynı zaman çizelgesine yerleştirilir. Birini açtığında alışverişin tamamını görürsün:
POST /api/v2/invoices HTTP/1.1
Content-Type: application/json
Authorization: [REDACTED]
{"customerId": "cus_8812", "lines": [{"sku": "PRO-M", "qty": 3}]}
HTTP/1.1 409 Conflict
Content-Type: application/json
{"error": "invoice_already_open", "invoiceId": "inv_3021"}
Body'lerin yanında durum kodunu, süreyi ve isteğin ne zaman başladığını da görürsün. İstekler videonun yanında zamana göre sıralandığı için yukarıdaki 409, onlarca görsel yüklemesinin arasında kaybolmak yerine ona yol açan tıklamanın hemen ardından gelir.
WebSocket mesajları
Gerçek zamanlı uygulamalar çoğu zaman HTTP'de değil, bir socket üzerinde bozulur. Midge WebSocket mesajlarını iki yönde de zaman damgalarıyla kaydeder; böylece sunucunun {"type":"price_update"} mesajını iki kez gönderdiğini ve istemcinin yalnızca ilkini gösterdiğini görebilirsin.
Diğer kaynaklar
Script'ler, stil dosyaları, görseller, fontlar ve dokümanlar body'leri olmadan durum kodu, boyut ve süreleriyle listelenir. Genelde ihtiyacın olan da budur: bir deploy'dan sonra app.4f2c1.js için dönen bir 404 ya da ilk çizimi geciktiren 3 MB'lık bir hero görseli.
GraphQL, olması gerektiği gibi
GraphQL ağ loglarını okumayı zorlaştırır. Her istek aynı /graphql endpoint'ine gider ve hatalar çoğu zaman HTTP 200 ile döner:
{
"data": { "updateProfile": null },
"errors": [{ "message": "Not authorized to update this profile", "path": ["updateProfile"] }]
}
Midge her GraphQL isteğinin yanında UpdateProfile gibi operasyon adını gösterir ve bir errors dizisi içeren 200 yanıtlarını işaretler. Durum koduna göre filtrelemenin gizleyeceği bir hata, hata olarak işaretlenir.
cURL olarak kopyala
Yakalanan her istek bir cURL komutu olarak kopyalanabilir; böylece bir backend geliştiricisi onu terminalden yeniden çalıştırıp aynı yanıtı görebilir. Maskeleme önce yapıldığı için Authorization header'ı ve çerezler [REDACTED] olarak gelir. Yerine kendi test hesabının token'ını koy ve çalıştır. Bu bilerek böyle: bir bug raporu asla çalışan bir oturumu başkasına vermemeli.
Maskelenmiş HAR dışa aktar
Bazı ekipler ve bazı sağlayıcılar HAR dosyası ister. Midge bir raporun ağ logunu HAR olarak indirmene izin verir ve dosya maskelenmiş verileri içerir. Onu ücretsiz HAR görüntüleyicide açabilir ya da anahtarlarını sızdırmadan bir API sağlayıcısına açtığın destek ticket'ına ekleyebilirsin. Doğrudan DevTools'tan dışa aktarılmış bir HAR'ın varsa, onu eklentiyle aynı kuralları kullanan HAR temizleyiciyle temizle.
Neler maskelenir
Şifreler, kart numaraları, token'lar ve çerezler, hiçbir şey cihazından çıkmadan önce tarayıcında maskelenir. Ağ verilerinde bu şu anlama gelir:
Authorization,Cookie,Set-Cookie, API anahtarı ve CSRF header'ları ile adında token, secret, session ya da auth gibi kelimeler geçen her header.access_token,code,api_keyvesignaturegibi hassas URL parametreleri.- İç içe olanlar dahil
password,otp,cvv,ibanya dacard_numbergibi body alanları. - Payload'un herhangi bir yerindeki JWT'ler, Luhn kontrolünden geçen kart numaraları ve bilinen API anahtarı formatları.
E-postalar ve uluslararası telefon numaraları yarı maskelenir. Tam liste maskeleme sayfasında.
Sınırlar
İstek ve yanıt body'leri fetch, XHR ve WebSocket için yakalanır; diğer kaynak türlerinde yalnızca meta veriler görünür. Chrome dışındaki uygulamaların trafiği rapora dahil değildir ve Midge, asla yakalama yapmaması için listeye eklediğin sitelerde çalışmaz. Tek seferlik bir inceleme için tarayıcı düzeyinde eksiksiz bir yakalamaya ihtiyacın varsa, Chrome'da ağ trafiğini yakalama rehberimiz DevTools yolunu anlatıyor.
Midge ücretsiz: sınırsız kayıt, 15 dakikaya kadar video ve filigran yok.
Sık sorulan sorular
- Midge hangi istekleri yakalıyor?
- Header'ları, istek ve yanıt body'leri, durum kodları ve süreleriyle fetch ve XHR isteklerini, ayrıca WebSocket mesajlarını. Script, stil dosyası, görsel, font ve doküman gibi diğer kaynaklar durum, boyut ve süreleriyle listelenir.
- Ağ logunu HAR dosyası olarak dışa aktarabilir miyim?
- Evet. Bir raporun ağ logu HAR dosyası olarak indirilebilir ve indirilen dosya ham değerleri değil, maskelenmiş verileri içerir.
- Midge GraphQL'i nasıl ele alıyor?
- Her GraphQL isteği için operasyon adını gösterir ve HTTP 200 dönen ama bir errors dizisi içeren yanıtları işaretler; durum koduna göre filtreleme bunları kaçırırdı.
- cURL olarak kopyalarken auth token'ım da gelir mi?
- Hayır. Authorization header'ları ve çerezler yüklemeden önce maskelenir; bu yüzden kopyalanan komutta onların yerinde [REDACTED] yazar. Çalıştırırken kendi token'ını ekle.