Laporan Kesalahan memungkinkan Anda melihat kesalahan dan peringatan sistem Luau terkini untuk server dan klien. Pantau laporan kesalahan Anda sebelum dan setelah memperbarui permainan Anda untuk mengidentifikasi masalah potensial lebih awal.
Lihat laporan kesalahan Anda
Untuk melihat laporan kesalahan permainan Anda:
- Navigasikan ke halaman Kreasi Anda di Dasbor Kreator dan pilih permainan Anda.
- Di bawah Pemantauan, pilih Laporan Kesalahan.
Anda dapat melihat analitik untuk pengalaman individu atau milik grup. Untuk melihat yang terakhir, Anda perlu memiliki izin grup untuk analitik.
Pantau kesalahan dan peringatan
Anda dapat menerapkan filter dan toggle berikut ke laporan kesalahan Anda:
- Rentang tanggal — Filter untuk 1 jam terakhir, 1 hari terakhir, 7 hari terakhir, atau 30 hari terakhir.
- Tempat — Filter berdasarkan tempat.
- Tampilkan versi — Menambahkan anotasi versi tempat ke grafik kesalahan dan peringatan.
- Tingkat keparahan — Filter untuk menunjukkan kesalahan, peringatan, atau keduanya.
- Platform — Filter untuk menunjukkan kesalahan klien dari perangkat tertentu.
- OS — Filter untuk menunjukkan kesalahan klien dari sistem operasi tertentu.
- Kesalahan baru sejak — Filter untuk menunjukkan hanya kesalahan dan peringatan baru sejak versi tertentu.
Di bawah filter dan toggle, grafik menampilkan jumlah kesalahan dan peringatan untuk server, klien, dan total. Gunakan grafik ini untuk mencari peningkatan kesalahan dan peringatan dari waktu ke waktu. Jika Anda melihat lonjakan besar dalam kesalahan dan peringatan, gunakan tabel laporan kesalahan untuk memecahkan masalah.
Memecahkan masalah kesalahan dan peringatan
Tabel Kesalahan dan Peringatan memiliki kolom-kolom berikut:
| Kolom | Deskripsi |
|---|---|
| Hitung | Jumlah kesalahan atau peringatan. |
| Tingkat keparahan | Label kesalahan atau peringatan. |
| Tipe | Label server atau klien. |
| Pesan | Pesan kesalahan atau peringatan. |
| Pertama kali terlihat di | Timestamp pertama kali terlihatnya pesan tersebut. |
| Versi pertama terlihat | Hanya tersedia saat tempat dipilih. Menunjukkan versi pertama di mana pesan tercatat. |
Lihat jejak tumpukan untuk kesalahan atau peringatan
Jika Anda melihat dropdown pada kesalahan atau peringatan, klik untuk memperluas dan melihat jejak tumpukan yang sesuai. Jejak tumpukan adalah daftar panggilan yang dilakukan permainan Anda ketika pengecualian dilempar. Ini dapat membantu Anda untuk memahami apa yang salah.
Aturan Kustom
Aturan kustom memungkinkan Anda mendefinisikan pola regex atau string yang tepat untuk secara otomatis mengabaikan atau mengelompokkan kesalahan dan peringatan. Ini membantu Anda mengelola rasio sinyal terhadap kebisingan dari laporan kesalahan Anda. Anda dapat membuat hingga 100 aturan per pengalaman. Aturan dievaluasi dari atas ke bawah dalam urutan prioritas. Setelah kesalahan cocok dengan aturan, pemrosesan lebih lanjut dihentikan.
Tindakan aturan
Setiap aturan memiliki salah satu dari dua tindakan:
| Tindakan | Perilaku |
|---|---|
| Abaikan | Menyembunyikan kesalahan yang cocok dari grafik dan tabel. Gunakan untuk kebisingan permanen seperti kesalahan suara mesin yang tidak dapat dihindari atau pernyataan cetak yang sudah usang. |
| Kelompok | Mengkonsolidasikan semua kesalahan yang cocok di bawah nama kelompok kustom (misalnya, "Masalah Jaringan", "Spam Audio"). Nama kelompok muncul sebagai satu baris di tabel. |
Buat aturan
Ada dua cara untuk membuat aturan:
Dari tabel kesalahan (inline):
- Klik menu konteks (tiga titik) pada baris kesalahan mana pun.
- Pilih Abaikan.
Dari tab aturan:
- Navigasikan ke tab Aturan di halaman Laporan Kesalahan.
- Klik Buat Aturan.
- Masukkan pola (string yang tepat atau regex).
- Pilih tindakan: Abaikan atau Kelompok → [Nama Grup].
- Simpan aturan.
Bidang pembuatan aturan
| Bidang | Deskripsi |
|---|---|
| Pola | String yang tepat atau ekspresi reguler untuk dicocokkan dengan pesan kesalahan. |
| Tindakan | Pilih Abaikan (sembunyikan kesalahan) atau Kelompok → masukkan nama kelompok kustom. |
Aturan dievaluasi dari atas ke bawah berdasarkan urutan prioritas di tab Aturan. Setelah kesalahan cocok dengan aturan, tindakan dari aturan itu dieksekusi dan tidak ada aturan lebih lanjut yang dievaluasi untuk kesalahan itu. Ini menghindari konflik seperti kesalahan yang dikelompokkan oleh satu aturan dan kemudian diabaikan oleh aturan berikutnya.
Aturan hanya berdampak pada kesalahan yang dicatat setelah mereka disimpan. Anotasi muncul di grafik Anda ketika aturan diubah.
Dasar-dasar ekspresi reguler
Ekspresi reguler (regex) adalah pola yang mencocokkan teks:
| Sintaks | Arti | Contoh |
|---|---|---|
| . | Karakter tunggal apa pun | H.t mencocokkan "Hat", "Hit", "Hot" |
| * | Nol atau lebih dari karakter yang mendahuluinya | go*d mencocokkan "gd", "god", "good" |
| + | Satu atau lebih dari karakter yang mendahuluinya | go+d mencocokkan "god", "good", tetapi tidak "gd" |
| .* | Urutan karakter apa pun (wildcard) | Failed.*load mencocokkan "Failed to load" dan "Failed xyz load" |
| \d | Digit apa pun (0-9) | v\d+ mencocokkan "v1", "v123", "v4488" |
| \w | Karakter kata apa pun (huruf, digit, garis bawah) | \w+ mencocokkan "Player123", "my_var" |
| ^ | Awal string | ^HTTP mencocokkan kesalahan yang dimulai dengan "HTTP" |
| \/ | Garis miring yang diteruskan | rbxassetid:\/\/ mencocokkan "rbxassetid://" |
| \[ dan \] | Tanda kurung siku yang diteruskan (pencocokan literal) | \[Knit\] mencocokkan "[Knit]" |
| (a|b) | Mencocokkan "a" atau "b" | (Error|Warning):.* mencocokkan baik "Error: ..." maupun "Warning: ..." |
Tips cepat:
- Mulailah dengan pencocokan yang tepat (string kesalahan lengkap) jika Anda hanya ingin menangkap satu kesalahan tertentu.
- Gunakan regex ketika Anda ingin menangkap sekeluarga kesalahan yang mirip (misalnya, semua kegagalan memuat suara tanpa memperhatikan ID aset).
- Uji pola Anda terhadap beberapa string kesalahan nyata sebelum menyimpan untuk memastikan ia menangkap apa yang Anda harapkan.
Sistem memberlakukan dua aturan pada pola regex Anda:
- Anda tidak dapat menempatkan repeater (+ atau *) di dalam grup yang berulang. Misalnya, (a+)* atau (\w+)+ ditolak.
- Harus dimulai dengan teks yang dipasangkan: Pola tidak dapat dimulai dengan wildcard seperti .* atau .+. Pola Anda harus dimulai dengan karakter konkret atau jangkar (seperti ^ atau string literal).
Contoh aturan untuk mengorganisasi laporan kesalahan Anda
Alih-alih melihat puluhan baris kesalahan terpisah, konsolidasikan kesalahan terkait di bawah satu nama kelompok:
| Kasus penggunaan | Kesalahan contoh | Pola | Tindakan |
|---|---|---|---|
| Semua kesalahan jaringan | HttpError: ConnectFail, HttpError: Timedout | HttpError:.* | Kelompok → "Masalah Jaringan" |
| Peringatan DataStore | DataStore request was added to queue, DataStoreService: ... | DataStore | Kelompok → "Peringatan DataStore" |
| Kesalahan GUI Pemain | Players.Player1.PlayerGui.Shop:12: attempt to index nil | Players\.\w+\.PlayerGui | Kelompok → "Kesalahan PlayerGui" |
| Kerangka UI Kustom | [UIManager] Button render failed, [UIManager] Layout overflow | \[UIManager\].* | Kelompok → "Sistem UI" |
Batas Pelacakan Kesalahan
Sistem melacak hingga 500 kesalahan unik dan 500 peringatan unik berdasarkan hitungan dan 100 kesalahan baru teratas per versi. Hitungan ini direset setiap 6 jam. Untuk memaksimalkan pelacakan kesalahan yang berguna dalam batasan ini:
- Hapus pengidentifikasi unik dari pesan kesalahan, seperti ID pengguna, koordinat, atau timestamp. Kesalahan seperti Pemain 12345 gagal memuat dan Pemain 67890 gagal memuat dihitung sebagai dua entri terpisah. Jika Anda mencatatnya sebagai Pemain gagal memuat, mereka akan terakumulasi menjadi satu entri dengan hitungan yang lebih tinggi.
- Gunakan aturan kustom untuk mengelompokkan kesalahan terkait yang hanya berbeda dengan nilai dinamis.
Menyelesaikan kesalahan dan peringatan
Saat menyelidiki kesalahan dari halaman Laporan Kesalahan, gunakan pendekatan berikut:
- Tinjau jejak tumpukan — Perluas baris kesalahan untuk melihat jalur panggilan dan identifikasi skrip dan nomor baris tepat di mana kesalahan terjadi.
- Periksa pembaruan terbaru — Pantau kesalahan baru sejak pembaruan terbaru Anda.
- Gunakan alat bawaan:
- Konsol Pengembang (F9 dalam permainan): Lihat kesalahan secara langsung dan uji perbaikan.
- Profiler Skrip: Identifikasi kesalahan terkait kinerja yang disebabkan oleh operasi yang mahal.
- Output Window di Studio — Tangkap kesalahan selama pengembangan sebelum menerbitkan.
- Gunakan pemecahan — Periksa apakah kesalahan spesifik untuk platform (Desktop, Mobile, Console) atau OS (Windows, macOS, iOS, Android).
- Kumpulkan umpan balik komunitas — Jika Anda memiliki Discord komunitas atau posting DevForum, periksa apakah pemain melaporkan masalah dan perangkat atau wilayah mana yang terpengaruh.