Dokümantasyon 19 / 19

Tarayıcı senaryosu ve sayfa hızı

Özellik sayfası: Tarayıcı senaryosu izleme Sayfa hızı izleme

Gerçek bir tarayıcıyla iki tür izleme yapabilirsiniz: tarayıcı senaryosu (giriş, sepet, form gibi çok adımlı kullanıcı akışları) ve sayfa hızı (Core Web Vitals laboratuvar ölçümleri). Her iki tür de ücretli paketlerde vardır ve Chrome tarayıcısı kurulu ölçüm ajanlarında çalışır.

Tarayıcı senaryosu

Senaryo, sizin tanımladığınız adımları gerçek bir Chrome tarayıcısında sırayla çalıştırır. Kod yazmanız gerekmez — ve güvenlik nedeniyle kabul edilmez: yalnızca aşağıdaki hazır eylemler vardır. Başlangıç adresi (monitörün hedefi) örtük ilk adımdır; en fazla 25 adım eklenebilir. Adımları düzenleyicide sürükleyerek ya da ok düğmeleriyle sıralayabilirsiniz.

Eylem	Ne yapar
Adrese git	Verilen adresi açar ve sayfanın yüklenmesini bekler (sayfa HTTP 4xx/5xx dönerse adım başarısız olur).
Tıkla	Öğe görünür, etkin ve üstte olana kadar bekler, sonra gerçek bir fare tıklaması yapar.
Alanı doldur	Alanı temizler ve değeri yazar. Gizli işaretlenirse değer şifreli saklanır, bir daha gösterilmez.
Seçenek seç	Açılır listede (`<select>`) değeri ya da görünen adı verilen seçeneği seçer.
Tuşa bas	Enter, Tab, Escape, ok tuşları vb.; isteğe bağlı olarak önce bir öğeye odaklanır.
Öğeyi bekle	Öğe görünür (ya da gizli) olana kadar bekler.
Sayfa geçişini bekle	Önceki adımın (ör. "Giriş yap" tıklaması) başlattığı sayfa geçişinin tamamlanmasını bekler.
Metni doğrula	Sayfada (ya da bir öğede) metnin bulunduğunu / bulunmadığını doğrular.
Adresi doğrula	Güncel adresin bir parçayı içerdiğini doğrular (ör. `/hesabim`).
Öğe sayısını doğrula	Seçiciye uyan öğe sayısı =, ≥ veya ≤ bir değer olmalı (ör. sepette en az 1 ürün).
Görünümü değiştir	Masaüstü, tablet, mobil ön ayarları veya özel boyut.
Ekran görüntüsü noktası	Senaryo sonraki bir adımda başarısız olursa bu andaki görüntü de kanıta eklenir.

Seçiciler CSS biçimindedir (#email, .sepet-toplam, button[type=submit], main h1) ya da görünen metne göre text= kısayolu: text=Giriş yap görünen metninde "giriş yap" geçen (büyük/küçük harf duyarsız) en içteki öğeyi, text="Giriş yap" metni birebir bu olan öğeyi bulur. XPath ve JavaScript desteklenmez. Doğrulama adımları, adım süresi dolana kadar sayfanın hazır olmasını otomatik bekler.

Süreler: her adım için bekleme süresi (varsayılan 10 sn, adım başına 1–30 sn değiştirilebilir) ve tüm senaryo için toplam süre (en fazla 60 sn). Yanıt süresi olarak adımların toplam süresi kaydedilir; monitör detayında her adımın son çalıştırmadaki süresini görürsünüz.

Örnek: giriş akışı

Başlangıç: https://ornek.com.tr/giris
Alanı doldur #email → test@ornek.com.tr
Alanı doldur #password → parola (Gizli)
Tıkla text=Giriş yap
Sayfa geçişini bekle
Metni doğrula "Hoş geldiniz"
Öğe sayısını doğrula .siparis-satiri ≥ 1

Düzenleyicideki Örnek giriş senaryosuyla başla bağlantısı bu adımların iskeletini ekler. İzleme için gerçek müşteri hesabı yerine ayrı bir test hesabı kullanmanızı öneririz.

Hata olduğunda ne görürüm?

Senaryo başarısız olduğunda monitör kesinti sayılır (her zamanki doğrulama ve eşik kurallarıyla) ve bildirim metni hangi adımın neden başarısız olduğunu söyler: "Adım 4 (tıkla text=Giriş yap): öğenin üzerinde başka bir öğe var (ör. çerez bildirimi), tıklanamadı". Kanıtı göster ile şunları görürsünüz:

Hata anındaki ekran görüntüsü (görünür alan, 1280×800) ve varsa son ekran görüntüsü noktası,
adım zaman çizelgesi (her adımın süresi ve durumu),
sayfadaki konsol hataları (en fazla 50 satır) ve başarısız ağ istekleri (adres ve durum kodu),
ağ politikasının engellediği bağlantılar.

Adresteki sorgu değerleri *** ile gizlenir. Ekran görüntüleri, konsol satırları ve ağ listesi yalnızca monitörü yönetebilen üyelere gösterilir; adım çizelgesi ve hata metni monitörü görebilen herkese açıktır. Ekran görüntüleri veritabanında değil özel depoda tutulur ve paketinizin kanıt saklama süresi dolunca silinir.

Gizli değerler

Gizli işaretli değerler (parola, tek kullanımlık test kodu vb.) uygulama anahtarıyla şifreli saklanır, düzenleme formunda ve API'de bir daha gösterilmez (••••••), hata metinlerinden, konsol satırlarından ve kanıttan maskelenir. Ekran görüntüsünde gizli değer yazılan alanlar siyah kutuyla kapatılır; gizli değer sayfa metninde görünüyorsa (ör. "Kullanıcı x bulunamadı") o çalıştırmada ekran görüntüsü hiç alınmaz. Monitörün adresini başka bir hosta taşırsanız gizli değerleri yeniden girmeniz gerekir. Resim veya canvas içine çizilen metinler denetlenemez; bu nedenle test hesabı kullanın.

Sayfa hızı

Sayfa hızı monitörü sayfanızı her kontrolde taze, önbelleksiz bir tarayıcıda açar ve şu laboratuvar ölçümlerini kaydeder:

Ölçüm	Anlamı	Varsayılan eşik (performans sorunu / kesinti)
LCP	En büyük içeriğin göründüğü an	2,5 sn / 4 sn
FCP	İlk metin veya görselin çizildiği an	1,8 sn / 3 sn
CLS	Beklenmeyen düzen kaymalarının toplamı	0,1 / 0,25
TBT	Sayfanın etkileşime kapalı kaldığı toplam süre	200 ms / 600 ms
TTFB	Sunucunun ilk yanıt süresi	800 ms / 1,8 sn

Ayrıca yükleme süresi, aktarılan veri ve istek sayısı kaydedilir; bunlara da eşik tanımlayabilirsiniz. Varsayılan eşikler Google'ın Core Web Vitals "iyi" ve "iyileştirilmeli" sınırlarıdır; boş bırakılan eşik uygulanmaz. Herhangi bir kesinti eşiği aşılırsa monitör kesinti, yalnızca performans sorunu eşikleri aşılırsa performans sorunu olur.

Cihazlar: Masaüstü (1350×940) ve/veya Mobil (412×823, 4× yavaş CPU ve yavaş 4G benzeri ağ kısıtlaması). İkisi seçilirse her kontrolde iki ayrı ölçüm yapılır. Monitör detayında her ölçümün son değeri (İyi / İyileştirilmeli / Kötü) ve 24 saat, 7 gün, 30 günlük eğilim grafikleri bulunur.

Bunlar tek bir tarayıcı ve lokasyondan alınan laboratuvar ölçümleridir; gerçek kullanıcı verileri (Chrome UX Report) ve PageSpeed Insights puanıyla birebir aynı olmayabilir. Gerçek ziyaretçi ölçümleri için Gerçek kullanıcı izleme sayfasına bakın.

Hedef doğrulaması ve güvenlik

Başlangıç adresinin ve Adrese git adımlarındaki her hostun doğrulanmış hedef olması gerekir.
Çalışma sırasında sayfanın kendisi (tıklama, form, yönlendirme) yalnızca doğrulanmış hostlarınızda gezinebilir. Başka bir alan adına gitmeye çalışırsa kontrol hata ile biter ve engellenen host gösterilir (ör. ornek.com.tr → www.ornek.com.tr yönlendirmesi için alt alan adlarını da kapsayan doğrulama yapın). Bu nedenle başka bir alan adındaki kimlik sağlayıcısına (ör. Google/Microsoft ile giriş) yönlenen akışlar genel lokasyonlardan izlenemez.
CDN, analitik, yazı tipi gibi alt kaynaklar serbesttir; ancak tarayıcı trafiği ölçüm ajanındaki ağ politikasından geçer: iç ağ, loopback ve bulut metadata adreslerine hiçbir bağlantı yapılmaz.
Her çalıştırma temiz bir profille ve tek sayfayla yapılır; indirmeler, açılır pencereler, service worker'lar ve WebRTC kapalıdır. Tarayıcı, ölçüm ajanının kendi sandbox'ında çalışır.
İsteklerde tarayıcının User-Agent değerine ajanımızın tanımlayıcısı eklenir (… Isletme/1.0 (+https://isletme.net.tr/bot)); izleme trafiğini analitiğinizden bu değerle ayırabilirsiniz.

Paketler ve sınırlar

Yalnızca ücretli paketler: paketinize göre tarayıcı senaryosu ve sayfa hızı monitör sayısı ile en kısa kontrol aralığı sınırlıdır (paket karşılaştırması: Paketler).
Tür alt sınırı: senaryo en az 5 dakika, sayfa hızı en az 15 dakika aralıkla çalışır.
Tarayıcı kapasitesi platform genelinde sınırlıdır; yoğunlukta kontrol birkaç saniye gecikebilir.
Özel lokasyonda (kendi ağınızdaki ajan) tarayıcı türleri, ajan sunucunuza Chrome for Testing chrome-headless-shell kurduğunuzda çalışır; iç adresler özel lokasyon kurallarıyla izlenebilir.
API: monitör oluşturma/güncellemede type: "browser" ve browser.steps[], ya da type: "pagespeed" ve pagespeed.devices / pagespeed.budgets (bkz. REST API).

Bu belge ürünün mevcut davranışını anlatır. Bir tutarsızlık görürseniz lütfen bize bildirin.