Hata Raporu size hem sunucu hem de istemci için güncel Luau sistem hatalarını ve uyarılarını görüntüleme imkanı tanır. Oyunuzu güncelledikten önce ve sonra hata raporunuzu kontrol ederek olası sorunları erken tespit edebilirsiniz.
Hata raporunuzu görüntüleyin
Oyununuza ait hata raporunu görüntülemek için:
- Yaratıcı Kontrol Paneli'nde Yaratımlar sayfanıza gidin ve oyununuzu seçin.
- İzleme bölümünde Hata Raporu'nu seçin.
Bireysel veya grup sahipliğinde olan deneyimlerin analitiklerini görüntüleyebilirsiniz. İkincisini görüntülemek için analitik için grup izinlerine sahip olmalısınız.
Hataları ve uyarıları izleyin
Hata raporunuza aşağıdaki filtreleri ve anahtarları uygulayabilirsiniz:
- Tarih aralığı — Son 1 saat, son 1 gün, son 7 gün veya son 30 gün için filtreleme.
- Yer — Yer bazında filtreleme.
- Versiyonu göster — Hatalar ve uyarılar grafiğine yer versiyonu notları ekler.
- Şiddet — Hataları, uyarıları veya her ikisini göstermek için filtreleme.
- Platform — Belirli cihazlardan gelen istemci hatalarını göstermek için filtreleme.
- İşletim Sistemi — Belirli işletim sistemlerinden gelen istemci hatalarını göstermek için filtreleme.
- Yeni hatalar — Belirli bir versiyondan bu yana yalnızca yeni hata ve uyarıları göstermek için filtreleme.
Filtreler ve anahtarların altında, sunucu, istemci ve toplam için hata ve uyarı sayılarını gösteren bir grafik görüntülenir. Bu grafiği, zaman içinde hatalarda ve uyarılarda artış olup olmadığını kontrol etmek için kullanın. Hatalarda ve uyarılarda büyük bir artış görüyorsanız, sorun gidermek için hata raporu tablosunu kullanın.
Hataları ve uyarıları giderin
Hatalar ve uyarılar tablosu aşağıdaki sütunları içerir:
| Sütun | Açıklama |
|---|---|
| Sayı | Hata veya uyarıların sayısı. |
| Şiddet | Hata veya uyarı etiketi. |
| Tür | Sunucu veya istemci etiketi. |
| Mesaj | Hata veya uyarı mesajı. |
| İlk görüldüğü yer | Mesajın ilk görüldüğü zaman damgası. |
| İlk görülen versiyon | Yalnızca bir yer seçildiğinde mevcut. Mesajın kaydedildiği ilk versiyonu gösterir. |
Hata veya uyarı için yığın izini görüntüleyin
Bir hata veya uyarıda bir açılır menü görürseniz, genişletmek için tıklayın ve karşılık gelen yığın izini görün. Yığın izi, hata fırlatıldığında oyununuzun gerçekleştirdiği çağrıların bir listesidir. Bu, neyin yanlış gittiğini anlamanıza yardımcı olabilir.
Özel kurallar
Özel kurallar, hataları ve uyarıları otomatik olarak görmezden gelmek veya gruplamak için regex veya tam string desenleri tanımlamanızı sağlar. Bu, hata raporlarınızın sinyal-gürültü oranını yönetmenize yardımcı olur. Her deneyim için en fazla 100 kural oluşturabilirsiniz. Kurallar, öncelik sırasına göre yukarıdan aşağıya doğru değerlendirilir. Bir hata bir kuralı karşıladığında, daha fazla işlem durur.
Kural eylemleri
Her kuralın iki eylemden biri vardır:
| Eylem | Davranış |
|---|---|
| Göz ardı et | Grafikten ve tablodan eşleşen hataları gizler. Kaçınılmaz motor ses hataları veya eski print ifadeleri gibi kalıcı gürültüler için kullanın. |
| Grupla | Eşleşen tüm hataları özel bir grup adı altında konsolide eder (örneğin, "Ağ Sorunları", "Ses Spamı"). Grup adı tabloda tek bir satır olarak görünür. |
Kural oluştur
Bir kural oluşturmanın iki yöntemi vardır:
Hata tablosundan (satır içi):
- Herhangi bir hata satırındaki bağlam menüsüne (üç nokta) tıklayın.
- Göz ardı et seçeneğini seçin.
Kurallar sekmesinden:
- Hata Raporları sayfasında Kurallar sekmesine gidin.
- Kural Oluştur'a tıklayın.
- Bir desen girin (tam string veya regex).
- Bir eylem seçin: Göz ardı et veya Grupla → [Grup Adı].
- Kuralı kaydedin.
Kural oluşturma alanları
| Alan | Açıklama |
|---|---|
| Desen | Hata mesajlarına karşı eşleşecek tam string veya düzenli ifade. |
| Eylem | Göz ardı et (hata gizle) veya Grupla → özel grup adı girin. |
Kurallar, Kurallar sekmesinde öncelik sırasına göre yukarıdan aşağıya doğru değerlendirilir. Bir hata bir kuralı karşıladığında, o kuralın eylemi gerçekleştirilir ve daha fazla kural, o hata için değerlendirilmez. Bu, bir hatanın bir kural tarafından gruplanıp daha sonra başka bir kural tarafından göz ardı edilmesi gibi çelişkileri önler.
Kurallar yalnızca kaydedildikten sonra günlüklenen hataları etkiler. Kurallar değiştirildiğinde grafiğinizde bir not görünür.
Düzenli ifade temelleri
Düzenli ifade (regex), metni eşleştiren bir desendir:
| Söz Dizimi | Anlamı | Örnek |
|---|---|---|
| . | Herhangi bir tek karakter | H.t "Şapka", "Vuruş", "Sıcak" ile eşleşir |
| * | Önceki karakterden sıfır veya daha fazlası | go*d "gd", "god", "good" ile eşleşir |
| + | Önceki karakterden bir veya daha fazlası | go+d "god", "good", ancak "gd" ile eşleşmez |
| .* | Herhangi bir karakter dizisi (wildcard) | Failed.*load "Yüklenmede hata" ve "Başarısız yüklenme" ile eşleşir |
| \d | Herhangi bir rakam (0-9) | v\d+ "v1", "v123", "v4488" ile eşleşir |
| \w | Herhangi bir kelime karakteri (harfler, rakamlar, alt çizgi) | \w+ "Player123", "my_var" ile eşleşir |
| ^ | Dizenin başlangıcı | ^HTTP "HTTP" ile başlayan hataları eşleştirir |
| \/ | Kaçış karakteriyle taksim işareti | rbxassetid:\/\/ "rbxassetid://" ile eşleşir |
| \[ ve \] | Kaçış karakteriyle köşeli parantezler (literal eşleşme) | \[Knit\] "[Knit]" ile eşleşir |
| (a|b) | "a" veya "b" ile eşleşir | (Error|Warning):.* hem "Hata: ..." hem de "Uyarı: ..." ile eşleşir |
Hızlı ipuçları:
- Yalnızca bir belirli hatayı yakalamak istiyorsanız tam bir eşleşmeyi (tüm hata stringi) ile başlayın.
- Benzer hata ailesini yakalamak istiyorsanız bir regex kullanın (örneğin, varlık ID'sine bakılmaksızın tüm ses yükleme hataları).
- Kuralı kaydetmeden önce birkaç gerçek hata stringiyle deseninizi test edin, böylece beklediğinizi yakaladığından emin olun.
Sistem düzenli ifade desenlerinize iki kural uygular:
- Bir tekrar edici (+ veya *) tekrar eden bir grubun içine yerleştiremezsiniz. Örneğin, (a+)* veya (\w+)+ reddedilir.
- Sabit metinle başlamalıdır: Desenler, .* veya .+ gibi bir wildcard ile başlayamaz. Deseniniz somut bir karakter veya ankraj (örneğin, ^ veya literal bir string) ile başlamalıdır.
Hata raporlarınızı organize etmek için kural örnekleri
Ayrı hata satırları görmek yerine, ilişkili hataları tek bir grup adı altında konsolide edin:
| Kullanım durumu | Örnek hatalar | Desen | Eylem |
|---|---|---|---|
| Tüm ağ hataları | HttpError: ConnectFail, HttpError: Timedout | HttpError:.* | Grupla → "Ağ Sorunları" |
| Veri Depolama uyarıları | DataStore request was added to queue, DataStoreService: ... | DataStore | Grupla → "Veri Depolama Uyarıları" |
| Oyuncu GUI hataları | Players.Player1.PlayerGui.Shop:12: attempt to index nil | Players\.\w+\.PlayerGui | Grupla → "PlayerGui Hataları" |
| Özel UI çerçevesi | [UIManager] Button render failed, [UIManager] Layout overflow | \[UIManager\].* | Grupla → "UI Sistemi" |
Hata izleme sınırları
Sistem, sayısı ile en fazla 500 benzersiz hata ve 500 benzersiz uyarıyı izler ayrıca her versiyon için en fazla 100 yeni hata izler. Bu sayılar her 6 saatte bir sıfırlanır. Bu sınırlamalar içerisinde yararlı hata izlemeyi en üst düzeye çıkarmak için:
- Hata mesajlarından kullanıcı kimlikleri, koordinatlar veya zaman damgaları gibi benzersiz tanımlayıcıları çıkarın. Player 12345 failed to load ve Player 67890 failed to load gibi hatalar iki ayrı giriş olarak sayılır. Bunu Player failed to load olarak kaydederseniz, tek bir giriş altında daha yüksek bir sayı ile konsolide edilir.
- Dinamik değerlerden sadece farklılık gösteren ilişkili hataları gruplamak için özel kurallar kullanın.
Hata ve uyarıları çözme
Hata Raporları sayfasından hataları incelerken aşağıdaki yaklaşımları kullanın:
- Yığın izlerini gözden geçirin — Hata satırlarını genişleterek çağrı yolunu görün ve hatanın gerçekleştiği kesin script ve satır numarasını belirleyin.
- Son güncellemeleri kontrol edin — En son güncellemenizden bu yana yeni hataları izleyin.
- Dahili araçları kullanın:
- Geliştirici Konsolu (F9 oyunda): Canlı hataları gerçek zamanlı görün ve düzeltmeler test edin.
- Script Profiler: Pahalı işlemler tarafından neden olan performansla ilgili hataları belirleyin.
- Stüdyo'daki Çıktı Penceresi — Yayınlamadan önce geliştirme sırasında hataları yakalayın.
- Dağılımları kullanın — Hatanın belirli bir platforma (Masaüstü, Mobil, Konsol) veya işletim sistemine (Windows, macOS, iOS, Android) özgü olup olmadığını kontrol edin.
- Topluluk geri bildirimlerini toplayın — Bir Discord topluluğunuz veya DevForum gönderiniz varsa, oyuncuların sorunu bildirdiği ve hangi cihazların veya bölgelerin etkilendiğini kontrol edin.