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.

Etkileşimli derse başlaDers notlarını oku

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.

Uygulama dosyaları

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

Start hereUygulama 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.

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

Bu adımda kullanılan dosyalar

Start hereUygulama 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.

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.

Bu adımda kullanılan dosyalar

Start hereUygulama 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.

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.

Bu adımda kullanılan dosyalar

Start hereUygulama 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.

Ders işine yaradı mı?

Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.

Öğrenmeye devam edin

Diğer dersleri inceleyin