
Mini ders · Türkçe
Canlı sitenizdeki hatalar nasıl bulunur ve düzeltilir
Verilen bozuk ziyaretçi işlemini yeniden üretin, asistandan sınırlı düzeltme isteyin ve değişiklikten sonra aynı işlemi doğrulayın.
Bu ders kimler için?
Ziyaretçilerin karşılaştığı hataları bulup düzeltmek isteyenler için. Sağlanan bozuk sayfayı kullanacaksınız; siz sorunu anlatıp ziyaretçi işlemini tekrarlarken kodlama asistanı kodu değiştirebilir.
Başlamadan önce
Verilen ayrı alıştırma sitesi ve kodlama asistanı. İzleme bölümü için Sentry alıştırma projesi isteğe bağlıdır; yalnızca verilen yapay hataları gönderin, özel ziyaretçi verisi kullanmayın.
Tahmini süre: 19–31 dk
Hazır örnek dosyalarla, gerekli hesap ve araçlar kurulmuşken çalışma tahmini. Kurulum, yayınlanma sırası ve e-posta/DNS beklemeleri ayrıca zaman alabilir. İzleme sağlayıcısının kurulumu ve veriyi alması için bekleme ek süre gerektirir. Yereldeki yakalama çağrısı, alınmış bir uyarının kanıtı değildir.
Neler öğreneceksin?
- Yalnızca sayfa yüklenmesini kontrol etmek yerine gerçekten bozuk işlemi yeniden üretin.
- Sınırlı asistan düzeltmesine yetecek güvenli bağlamı paylaşın.
- Düzeltilen işlemi ve ilgili izleme durumunu doğrulayın.
Adım 1
Ziyaretçi işlemini deneyin
Faydalı özelliği bozuk olsa bile sayfa açılabilir.
Sağlanan public klasörünü HTTP üzerinden sunup sayfayı açmasını asistandan isteyin. “Find contact section” kullanın. Sağlanan practice-R1 sürümü bilerek olmayan hedefi arar; bu yüzden durum Contact işleminin başarısız olduğunu bildirir.
Asistana tam düğmeyi, beklenen hedefi ve görünür sonucu söyleyin. Contact bölümü sayfada bulunurken düğme ona ulaşamayabilir; yalnızca yüklenen ana sayfaya bakmak sorunu kaçırırdı.
Somut bir örnek
Yararlı belirti raporu: “practice-R1’de Find contact section düğmesine bastım. Contact bölümünün açılmasını bekliyordum ama durum Contact action failed dedi.”
Verilen bozuk iletişim işlemi örneğini ayrı alıştırma sitesinde kullan. Düğme hatasını yeniden üret, sınırlı bir neden belirle ve yalnızca gerekeni değiştir. Aynı işlemi tekrarlamama ve önce/sonra karşılaştırmama yardım et. İzleme etkinse yalnızca yapay hataları ve kendi alıştırma projemi kullan; özel sayfa veya form verisi gönderme. Sırf çözüldü olarak işaretlendi diye sorunu düzelmiş sayma.Bu adımda kullanılan dosyalar
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Canlı site hatasını bulun ve düzeltin
Ziyaretçinin yapamadığı işlemden başlayın, ardından raporla nedenini bulun.
İzleme, gerçek belirtiyi araştırabileceğiniz kodla ilişkilendirdiğinde yararlıdır. Bu deneme sayfası bilerek var olmayan bir iletişim öğesini arar; bu yüzden iletişim bölümüne ulaşma işlemi başarısız olur.
Kendi Sentry projenize yalnızca sabit, yapay bir hata göndeririz. Rapor yayım sürümü etiketi ve çağrı yığını konumu içerir; olay kaydı bu kanıtı ziyaretçinin yapmaya çalıştığı işle ilişkilendirir.
Çözülmüş örnek
Ana sayfanın kendisi başarıyla yüklenir. “Find contact section” düğmesine tıklamak başarısız olur; çünkü gerçek HTML’de id=contact varken betik #contact-missing arar.
Extra implementation exercise
HTTP 200 dönen ana sayfa kontrolü neden bu hatayı yakalayamaz?
Çözülmüş örneği göster
HTML doğru yüklenirken sonraki JavaScript işlemi başarısız olabilir. Yalnızca sayfa isteğini değil, iletişim bölümüne ulaşma işlemini tekrarlayın.
- Sayfa yüklendikten sonra etkilenen etkileşimi test eder.
- Erişilebilirlikle işlevin doğru çalışmasını ayırır.
Sık yapılan hata
Sunucu HTML’i sunduğu için JavaScript özelliğinin sağlıklı olduğunu söylemek.
Adım 2
Yalnızca güvenli ve faydalı bağlam toplayın
Asistana özel ziyaretçi verisi olmadan kanıt verin.
Asistana deneme dosyalarını, sayfa sürümünü ve önceki adımdaki belirtiyi verin. Bu, gerçek ziyaretçinin form metnini veya hesap bilgisini göndermeden yerel örneği incelemeye başlamak için yeterli.
İsteğe bağlı Sentry projesini kullanıyorsanız yalnızca herkese açık yükleyici değerini ayarlayın ve kontrollü hatayı yeniden üretmeden deneme izlemesini açın. Eşleşen deneme olayını ve verisini inceleyin. Sentry’de olay görünmesi, gelen kutusuna uyarı ulaşmasından ayrıdır.
Somut bir örnek
Sağlanan izinli hata “Practice: missing contact target”. Yararlı olay, gerçek kullanıcı mesajı, e-posta adresi veya hesap token’ı olmadan deneme sürümünü ve kaynak konumunu içerebilir.
Sentry: tarayıcı yükleyicisi ve özel başlatma
Sıra sizde
Hangi bağlamı paylaşacak, hangi özel verileri hariç tutacaksınız?
Cevabını ders asistanıyla değerlendir
Çözülmüş örneği göster
Sağlanan practice-R1 dosyalarını, “Find contact section” işlemini ve hata mesajını paylaşırdım. İzleme açıkken test projemde “Practice: missing contact target” ve eşleşen sürümü arardım. Ziyaretçi e-postalarını, form metnini ve hesap token’larını dışlardım; gelen kutusu uyarısı ayrı kontrol olarak kalır.
- Tekrarlanabilir yapay işlemi, deneme sürümünü ve ilgili dosya bağlamını paylaşır.
- Gerçek ziyaretçi içeriğini dışlar; alınmış izleme olaylarını teslim edilmiş uyarılardan ayırır.
Bu adımda kullanılan dosyalar
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Kontrollü tanılama raporu gönderin
Ham kullanıcı içeriği göndermeden araştırmaya yetecek veri toplayın.
Herkese açık proje yükleyici URL’sini START-HERE.txt açıklamasına göre yapılandırın. Betik SDK’yı yüklemeden önce başlatma geri çağrısını ayarlar, tracing/replay özelliklerini kapatır ve bu sabit deneme hatası için beforeSend izin listesi kullanır.
Dönen tanılama olayı istek verisini, kullanıcı verisini, gelişigüzel ek alanları ve önceki işlemlerin breadcrumb kayıtlarını içermez. Çağrı yığını dosya adlarından sorgu/hash çıkarılır. Gerçek sitede hassas tanılama verisinin her kaynağını inceleyin; sendDefaultPii=false tek başına serbest metin veya URL’lerde kişisel bilgi bulunmadığını garanti etmez.
beforeSend filtresi bilerek katıdır: yalnızca tam olarak “Practice: missing contact target” yapay mesajı gönderilir. Diğer mesajlar elenir. Deneme hatasının metnini değiştirirseniz izin listesini bilinçli güncelleyin; aksi halde olayın görünmemesi beklenen sonuçtur. Sırf panel hareketlensin diye filtreyi kaldırmayın; izin verilen olayın veri yükünü istenmeyen bilgiler açısından inceleyin.
Olay gelmiyorsa önce app.js içindeki sabit mesajı ve beforeSend izin listesini inceleyin. Eşleşmeyen olay artık yerelde filtrelendiğini belirten mesaj gösterir; gönderilmiş sayılmaz. URL ayrıştırıcısı göreli dosya adları için location.origin değerini temel alır; ayrıştıramadığı adı, hassas olabilecek özgününü iletmek yerine redacted ile değiştirir.
Yükleyicinin belgelenen data-lazy="no" seçeneği script.dataset.lazy="no" ile ayarlanır; tam SDK’nın erken yüklenmesini ister. Çağrı yığını dosya adlarında sorgu/hash çıkarıldıktan sonra yalnızca HTTP(S) kökeni/yolu kalır. Web dışı şemalar değişmeden aktarılmak yerine gizlenir.
Çözülmüş örnek
“Practice: missing contact target” gibi sabit hata mesajı bu alıştırmaya yeter. Bütün form nesnesini göndermek, eksik DOM hedefini bulmaya yardım etmeden risk ekler.
Sentry: tarayıcı yükleyicisi ve özel başlatma
Extra implementation exercise
Varsayılan kişisel veri toplamayı kapatmak, gelişigüzel hata mesajlarının gönderilmesini kendiliğinden güvenli kılar mı?
Çözülmüş örneği göster
Hayır. Gerçek olay veri yükünü inceleyin ve kendi kodunuzun gönderdiğini sınırlayın. Varsayılan kişisel veri toplama kapalıyken bile mesajlarda, URL’lerde, breadcrumb kayıtlarında ve ek alanlarda kişisel veri olabilir.
- Uygulama metninin/URL’lerinin yine de özel veri içerebileceğini fark eder.
- Açık ayıklama ve izin listesi uygular.
Sık yapılan hata
Tek bir gizlilik seçeneğini tüm veri yükünün incelenmesi yerine koymak.
Adım 3
Sınırlı tek bir düzeltme uygulayın
Değişiklikten sonra başarısız işlemi aynen tekrarlayın.
Başarısız düğmenin hedefini mevcut Contact bölümüyle karşılaştırmasını asistandan isteyin. Sağlanan worked-solution/app.js küçük hedef düzeltmesini içerir; bu değişikliği uygulayıp düzeltilen deneme sürümünü practice-R2 diye etiketlesin.
Güncellenmiş practice-R2 sayfasını açıp aynı düğmeyi yeniden kullanın. Contact’a ulaşmalı ve “Contact section opened.” göstermeli. Yalnızca sürüm etiketini değiştirmek veya Sentry’de sorunu çözüldü işaretlemek düğmenin davranışını değiştirmez.
Somut bir örnek
Hatalı betik #contact-missing ararken HTML, Contact’ı #contact içinde tanımlar. Asistan eşleşmeyi düzeltebilir; sonucu düğmeyi yeniden kullanarak siz değerlendirirsiniz.
Sıra sizde
Ne değişti ve ilk işlemi tekrarladığınızda ne oldu?
Cevabını ders asistanıyla değerlendir
Çözülmüş örneği göster
Sağlanan çözümde asistan aramayı eksik hedeften mevcut #contact bölümüne değiştirir ve sürümü practice-R2 diye etiketler. Beklenen tekrar testi, aynı düğmenin Contact’a ulaşıp “Contact section opened.” göstermesidir. Bu test olmadan izlemedeki çözüldü etiketi düzeltmeyi doğrulamaz.
- Küçük hedef düzeltmesini mevcut Contact bölümüyle ilişkilendirir.
- Güncel sürümde aynı işlemi tekrarlar ve kullanıcıya görünür sonucu kontrol eder.
Bu adımda kullanılan dosyalar
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Raporu eşleştirin, nedeni düzeltin ve yeniden test edin
Bir sorunu çözüldü diye etiketlemek kodu düzeltmez.
İzlemeyi açın, yapay hatayı tetikleyin ve hesabınızda gerçek olayı bulun. Yayım sürümünü ve yığın çerçevesini verilen kaynakla karşılaştırın. Olay gelmezse hata olmadığını varsaymadan önce yüklemeyi, engelleyicileri, proje yapılandırmasını ve ağdan iletimi inceleyin.
Betiği worked-solution/app.js ile değiştirin, yayım sürümü etiketini güncelleyin ve iletişim işlemini tekrarlayın. Doğru hedef kaydırılarak görünür olmalıdır. Panelde sorunu çözüldü diye işaretlemek bu davranış kontrolünün yerine geçmez.
Dosya değiştirme, kaynak düzeltmesinin küçük bir laboratuvar gösterimidir. Barındırılan deneme sitesinde değişen app.js ve sürüm etiketini commit edin, o sürümü inceleyip dağıtın, sonra herkese açık URL’sinde yeniden test edin. Yalnızca sorun durumunu veya sürüm etiketini değiştirmek seçici düzeltmesini uygulamaz.
Çözülmüş örnek
R1, #contact-missing üzerinde başarısız olur; R2, #contact kullanır. Anlamlı toparlanma kanıtı, iletişim işleminin düzeltilmiş sürümde artık çalışmasıdır.
Extra implementation exercise
Sorun çözüldü diye işaretli ama dağıtılmış betik hâlâ #contact-missing arıyor. Sorun giderildi mi?
Çözülmüş örneği göster
Hayır. Panel durumu betiği değiştiremez. Düzeltmeyi inceleme sürecinden geçirip dağıtın ve işlemi o sürümde doğrulayın.
- Gerçekte dağıtılan kaynağı/sürümü kontrol eder.
- Önceden başarısız olan işlemi tekrarlar.
Sık yapılan hata
Düzeltmeyi yayımlayıp doğrulamak yerine sorun durumunu değiştirmek.
Adım 4
Faydalı bir olay notunu tamamlayın
Belirtiyi, düzeltmeyi ve doğrulamayı bağlantılı tutun.
incident-record.txt dosyasını özgün düğme hatası, küçük hedef düzeltmesi ve güncel sayfada aynı işlemin sonucu ile doldurun. Deneme değişikliğini yayımlarsanız yalnızca yerel dosyayı değil, tam yayımlanmış sürümü kontrol edin.
İsteğe bağlı izleme gözlemlerini ayrı tutun: Özgün olay Sentry’ye ulaştı mı, uyarı ayarladınız mı ve bildirim gerçekten geldi mi? Kayıt, sitenin bütünüyle hatasız olduğunu iddia etmek yerine düzeltilen görevi ve kalan eksikleri açıklamalı.
Somut bir örnek
Kısa olay notu practice-R1’deki başarısız Contact işlemini hedef düzeltmesine ve practice-R2’de başarılı tekrar testine bağlar. Yalnızca “sorun çözüldü” demek ziyaretçi sonucunu atlar.
Sıra sizde
Başlangıç malzemeleri
Başlangıç dosyaları ve deneme içerikleri hazır. Gerçek servis doğrulaması için Başlamadan önce bölümünde belirtilen kendi hesabınız, gelen kutunuz veya alan adınız gerekir. Bunlar olmadan dosyaları inceleyebilirsiniz; gerçekten denemediğiniz canlı adımı denenmedi diye kaydedin.
Olay kaydını ve gerçekten düzeltilen işlemin kontrolünü sunun.
Hazırlanacak çıktı Yeniden üretilen belirti, sınırlı değişiklik ve gerçekten başarılı yeniden sınamayı içeren kısa olay kaydı.
Cevabını ders asistanıyla değerlendir
Çözülmüş örneği göster
Örnek olay kaydı: practice-R1’in Contact düğmesi hata bildirdi; asistan eksik hedefi düzeltti; practice-R2’de aynı düğme Contact’a ulaşıp başarı mesajını gösterdi. Yapay olay, deneme izleme projesinde ayrıca kontrol edildi. Uyarı kuralı ayarlanmadığı için bildirim teslimatı denenmedi. Bu kayıt, gelecekteki bütün site hatalarını değil o Contact hatasını kapsar.
- Özgün belirtiyi, odaklı değişikliği ve belirtilen sürümdeki gerçek aynı işlem tekrar testini ilişkilendirir.
- Sağlayıcı olayı/uyarı gözlemlerini ayırır ve denenmemiş kalan kapsamı belirtir.
Bu adımda kullanılan dosyalar
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Ödeviniz: işe yarar bir olay notu yazın
Sonraki araştırmacının hem nedeni hem kanıtı anlamasını sağlayın.
Olay kaydını hassas bilgileri gizlenmiş olay referansı, etkilenen işlem, kaynak çerçevesi, kök neden ve başarılı yeniden testle tamamlayın. Uyarı yapılandırırsanız gerçek bildirimi, olayın sistemde alınmasından ayrı doğrulayın.
Kendi deneme kopyanızda ikinci bir yapay hata ekleyip döngüyü tekrarlayın. Mesajları sabit tutup izin listesini bilinçli güncelleyin; gelişigüzel sayfa/form verisi göndererek izleme kapsamını genişletmeyin.
Çözülmüş örnek
“Eksik hedef seçicisi #contact-missing yerine #contact olarak düzeltildi; R2 yeniden testi geçti” ifadesi ne yapıldığını anlatır. “Sentry’de hata vardı; çözüldü” neden ve doğrulamayı belirsiz bırakır.
Çözümün bütün adımlarını reference/assignment-walkthrough.txt dosyasında bulabilirsiniz. Adımları kendi sonucunuzla karşılaştırın; kontrol kaydını kendi projenizde gözlemlediklerinizle doldurun.
Extra implementation exercise
Olay notu hazırlayın ve düzeltilmiş kullanıcı işleminin çalıştığını kanıtlayın.
Çözülmüş örneği göster
Yapılandırılmış deneme yükleyicisini açın ve tam yapay hatayı tetikleyin. Hata metnini değiştirirseniz katı izin listesini bilerek güncelleyin; izin listesinde olmayan mesajın elenmesi beklenir. Gerçekte alınan olayda yayım sürümünü/çerçeveyi ve istenmeyen verileri inceleyin.
Verilen düzeltilmiş betiği public/app.js olarak uygulayın ve RELEASE değerini practice-R2 yapın. O deneme sürümünü incelenmiş iş akışından geçirerek yayımlayın, sonra gerçek dağıtılmış URL’de Find contact section işlemini tekrarlayın. Yalnızca sürüm etiketini veya sorun durumunu değiştirmek seçiciyi düzeltemez.
Sorunun sistemde alınmasını, uyarı bildiriminin tesliminden ayrı kaydedin. Yapılandırılmış uyarı gelmeden önce olay görünebilir; kontrol edilene kadar her gözlemi ayrı beklemede tutun. Örnek olay notu hatayı, çerçeveyi, seçici değişikliğini ve kullanıcının görebildiği yeniden testi ilişkilendirir.
- Belirtiyi, yayım sürümünü ve kaynaktaki nedeni ilişkilendirir.
- Davranışı doğrular; olayın alınması ve bildirimin teslim edilmesi iddialarını ayrı tutar.
Sık yapılan hata
Boş izleme panelinin kullanıcıların hiç hata görmediğini kanıtladığını varsaymak.
Ders işine yaradı mı?
Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.
Öğrenmeye devam edin
- İlk kişisel web sitenizi nasıl kurarsınız?
- Web sitenizi GitHub üzerinden nasıl yayımlarsınız?
- Kendi alan adınızı web sitenize nasıl bağlarsınız?
- Kendi alan adınızla e-posta nasıl kurulur
- Web sitenizi telefonda rahat kullanılır hale nasıl getirirsiniz?
- Web sitenizdeki görsellerin daha hızlı yüklenmesini nasıl sağlarsınız?
- Sitenize gelen geri bildirimler gelen kutunuza nasıl ulaşır
- Sitenize e-posta aboneliği nasıl eklenir
- Web sitenizden otomatik e-posta nasıl gönderirsiniz?
- Formdan gelen bilgileri veritabanına nasıl kaydedersiniz?
- İnsanların web sitenizde oturum açmasını nasıl sağlarsınız?
- Bir sayfayı nasıl yalnızca izin verilen kişilere açarsınız?
- Kullanıcıların profil bilgilerini düzenlemesini nasıl sağlarsınız?
- Kullanıcıların görsel yüklemesini nasıl sağlarsınız?
- API anahtarlarını tarayıcıya göndermeden nasıl kullanırsınız?
- Başka bir API’den gelen veriyi web sitenizde nasıl gösterirsiniz?
- Web sitenize yapay zekâ sohbeti nasıl eklersiniz?
- Sohbetin kendi içeriğinize dayanarak yanıt vermesini nasıl sağlarsınız?
- Web sitenize nasıl blog eklersiniz?
- Web sitenize nasıl arama eklersiniz?
- Web sitenize nasıl başka bir dil eklersiniz?
- Google’ın sitenizi bulmasına nasıl yardımcı olursunuz
- Bağlantı paylaşırken sitenizin önizlemesi nasıl düzeltilir
- Sitenizde ziyaretler ve yararlı işlemler nasıl ölçülür
- Ziyaretçilerin randevu almasını nasıl sağlarsınız?
- Web sitenizde ödeme nasıl alınır
- Yayımlamadan önce site değişiklikleri nasıl önizlenir
- Hatalı yayımlanan web sitenizi önceki çalışan sürüme nasıl döndürürsünüz?
- Web sitenizin verilerini nasıl yedekler ve geri yüklersiniz?