Pemecahan masalah dan FAQ Crashlytics

Anda mungkin melihat dua format berbeda untuk masalah yang tercantum dalam tabel Issues di Firebase console. Anda mungkin juga melihat fitur yang disebut "varian" dalam beberapa masalah. Berikut adalah alasannya.

Pada awal 2023, kami meluncurkan mesin analisis yang telah ditingkatkan untuk mengelompokkan peristiwa serta desain yang diperbarui dan beberapa fitur lanjutan untuk masalah baru (seperti varian). Lihat postingan blog terbaru kami untuk semua detailnya, tetapi Anda dapat membaca penjelasannya di bawah.

Crashlytics menganalisis semua peristiwa dari aplikasi Anda (seperti error, non-fatal, dan ANR) dan membuat kelompok peristiwa yang disebut masalah — semua peristiwa dalam masalah memiliki titik kegagalan yang sama.

Untuk mengelompokkan peristiwa ke dalam masalah ini, mesin analisis yang telah ditingkatkan kini melihat banyak aspek peristiwa, termasuk frame dalam stack trace, pesan pengecualian, kode error, dan karakteristik platform atau jenis error lainnya{101 }.

Namun, dalam kelompok peristiwa ini, stack trace yang mengarah ke kegagalan mungkin berbeda. Stack trace yang berbeda dapat berarti penyebab utama yang berbeda. Untuk merepresentasikan kemungkinan perbedaan ini dalam masalah, kami sekarang membuat varian dalam masalah - setiap varian adalah subgrup peristiwa dalam masalah yang memiliki titik kegagalan yang sama dan stack trace yang serupa. Dengan varian, Anda dapat men-debug stack trace yang paling umum dalam suatu masalah dan menentukan apakah penyebab utama yang berbeda menyebabkan kegagalan tersebut.

Berikut adalah hal yang akan Anda temukan dengan peningkatan ini:

• Metadata yang diperbarui ditampilkan dalam baris Issue
  Kini lebih mudah untuk memahami dan menanggulangi masalah di aplikasi Anda.

• Lebih sedikit masalah duplikat
  Perubahan nomor baris tidak menyebabkan masalah baru.

• Proses debug yang lebih mudah untuk masalah yang kompleks dengan penyebab utama berbeda
  Gunakan varian untuk men-debug stack trace yang paling umum dalam suatu masalah.

• Peringatan dan sinyal yang lebih bermakna
  Masalah baru benar-benar mewakili bug baru.

• Penelusuran yang lebih canggih
  Setiap masalah berisi metadata yang lebih mudah ditelusuri, seperti jenis pengecualian dan nama paket.

Berikut adalah peningkatan yang diluncurkan:

• Saat mendapatkan peristiwa baru dari aplikasi Anda, kami akan memeriksa apakah peristiwa tersebut cocok dengan masalah yang ada.

• Jika tidak ada kecocokan, kami akan otomatis menerapkan algoritme pengelompokan peristiwa yang lebih cerdas ke peristiwa tersebut dan membuat masalah baru dengan desain metadata yang diubah.

Ini adalah update besar pertama yang kami buat pada pengelompokan peristiwa. Jika Anda memiliki masukan atau mengalami masalah, beri tahu kami dengan mengirimkan laporan.

Jika Anda tidak melihat log breadcrumb, sebaiknya periksa konfigurasi aplikasi Anda untuk Google Analytics. Pastikan Anda memenuhi persyaratan berikut:

• Anda telah mengaktifkan Google Analytics di project Firebase Anda.

• Anda telah mengaktifkan Berbagi data untuk Google Analytics. Pelajari setelan ini lebih lanjut di artikel Mengelola setelan berbagi data Analytics

• Anda telah menambahkan Firebase SDK untuk Google Analytics ke aplikasi Anda. SDK ini harus ditambahkan sebagai tambahan ke Crashlytics SDK.

• Anda menggunakan versi Firebase SDK terbaru untuk semua produk yang digunakan di aplikasi Anda.

Jika Anda tidak melihat notifikasi kecepatan, pastikan Anda menggunakan Crashlytics SDK 11.7.0+.

Jika Anda tidak melihat metrik bebas error (seperti pengguna dan sesi bebas error) atau melihat metrik yang tidak dapat diandalkan, periksa hal berikut:

• Pastikan Anda menggunakan Crashlytics SDK 11.7.0+.

• Pastikan setelan pengumpulan data Anda tidak memengaruhi kualitas metrik bebas error:

  • Jika Anda mengaktifkan pelaporan keikutsertaan dengan menonaktifkan pelaporan error otomatis, informasi error hanya dapat dikirim ke Crashlytics dari pengguna yang secara eksplisit memilih ikut serta dalam pengumpulan data. Dengan demikian, akurasi metrik bebas error akan terpengaruh karena Crashlytics hanya memiliki informasi error dari pengguna yang ikut serta (bukan semua pengguna Anda). Artinya, metrik bebas error Anda mungkin kurang andal dan kurang mencerminkan stabilitas aplikasi secara keseluruhan.

  • Jika pengumpulan data otomatis dinonaktifkan, Anda dapat menggunakan sendUnsentReports untuk mengirim laporan yang di-cache di perangkat ke Crashlytics. Penggunaan metode ini akan mengirim data error ke Crashlytics, tetapi tidak mengirim data sesi yang menyebabkan diagram konsol menampilkan nilai rendah atau nol untuk metrik bebas error.

Lihat bagian Memahami metrik bebas error.

Jika Anda menggunakan IL2CPP Unity dan melihat stack trace yang tidak tersimbolisasi, coba lakukan hal berikut:

1. Pastikan Anda menggunakan Crashlytics Unity SDK v8.6.1 atau versi yang lebih tinggi.

2. Pastikan Anda sudah siap dan menjalankan perintah crashlytics:symbols:upload Firebase CLI untuk membuat dan mengupload file simbol.

   Anda harus menjalankan perintah CLI ini setiap kali membuat build rilis atau build apa pun yang ingin Anda lihat pelacakan tumpukan tersimbolisasinya di Firebase console. Pelajari lebih lanjut di halaman Mendapatkan laporan error yang dapat dibaca.

Ya, Crashlytics dapat menampilkan pelacakan tumpukan tersimbolisasi untuk aplikasi Anda yang menggunakan IL2CPP. Kemampuan ini tersedia untuk aplikasi yang dirilis di platform Apple atau Android. Berikut ini hal yang perlu Anda lakukan:

1. Pastikan Anda menggunakan Crashlytics Unity SDK v8.6.0 atau versi yang lebih tinggi.

2. Selesaikan tugas yang diperlukan untuk platform Anda:

   • Untuk aplikasi platform Apple: Anda tidak perlu melakukan tindakan khusus. Untuk aplikasi platform Apple, plugin Firebase Unity Editor otomatis mengonfigurasi project Xcode untuk mengupload simbol.

   • Untuk aplikasi Android: Pastikan Anda sudah siap dan menjalankan perintah crashlytics:symbols:upload Firebase CLI untuk membuat dan mengupload file simbol.

     Anda harus menjalankan perintah CLI ini setiap kali membuat build rilis atau build apa pun yang ingin Anda lihat pelacakan tumpukan tersimbolisasinya di Firebase console. Pelajari lebih lanjut di halaman Mendapatkan laporan error yang dapat dibaca.

Catatan memungkinkan anggota project untuk mengomentari masalah tertentu dengan pertanyaan, update status, dll.

Saat anggota project memposting catatan, catatan tersebut akan diberi label dengan email akun Google-nya. Alamat email ini akan terlihat bersama dengan catatan oleh semua anggota project yang memiliki akses untuk melihat catatan tersebut.

Berikut ini akan dijelaskan tentang akses yang diperlukan untuk melihat, menulis, dan menghapus catatan:

• Anggota project dengan salah satu peran berikut dapat melihat dan menghapus catatan yang ada dan menulis catatan baru tentang suatu masalah.

  • Pemilik atau Editor Project, Firebase Admin, Quality Admin, atau Crashlytics Admin

• Anggota project dengan salah satu peran berikut dapat melihat catatan yang diposting tentang masalah, tetapi mereka tidak dapat menghapus atau menulis catatan.

  • Project Viewer, Firebase Viewer, Quality Viewer, atau Crashlytics Viewer

Jika project Anda menggunakan Crashlytics bersama dengan Google Mobile Ads SDK, mungkin terjadi gangguan dari pelapor error saat pengendali pengecualian didaftarkan. Untuk memperbaiki masalah ini, nonaktifkan pelaporan error di Mobile Ads SDK dengan memanggil disableSDKCrashReporting.

Setelah Anda menautkan Crashlytics ke BigQuery, set data baru yang Anda buat secara otomatis berada di Amerika Serikat, terlepas dari lokasi project Firebase Anda.

Sebuah masalah mengalami regresi saat sebelumnya Anda telah menutupnya, tetapi Crashlytics mendapatkan laporan baru bahwa masalah tersebut muncul kembali. Crashlytics otomatis akan membuka kembali masalah yang mengalami regresi ini agar Anda dapat mengatasinya sebagaimana mestinya untuk aplikasi Anda.

Berikut contoh skenario yang menjelaskan cara Crashlytics mengategorikan masalah sebagai regresi:

1. Untuk pertama kalinya, Crashlytics mendapatkan laporan error terkait Error "A". Crashlytics akan membuka masalah terkait untuk error tersebut (Masalah "A").
2. Anda dapat memperbaiki bug ini dengan cepat, menutup Masalah "A", lalu merilis versi baru aplikasi.
3. Crashlytics akan menerima laporan lain tentang Masalah "A" setelah Anda menutup masalah.
   • Jika laporan berasal dari versi aplikasi yang diketahui Crashlytics saat Anda menutup masalah (artinya versi tersebut telah mengirimkan laporan error untuk error apa pun), Crashlytics tidak akan menganggap masalah tersebut sebagai regresi. Masalah akan tetap ditutup.
   • Jika laporan berasal dari versi aplikasi yang tidak diketahui Crashlytics saat Anda menutup masalah (artinya versi sama sekali tidak pernah mengirim laporan error untuk error apa pun), Crashlytics akan menganggap masalah mengalami regresi dan akan membuka kembali masalah tersebut.

Saat masalah mengalami regresi, kami mengirimkan pemberitahuan deteksi regresi dan menambahkan sinyal regresi ke masalah tersebut untuk memberi tahu Anda bahwa Crashlytics telah membuka kembali masalah ini. Jika Anda tidak ingin masalah dibuka kembali karena algoritma regresi kami, "nonaktifkan" masalah, bukan menutupnya.

Jika laporan berasal dari versi aplikasi lama yang belum pernah mengirim laporan error apa pun saat Anda menutup masalah, maka Crashlytics akan mempertimbangkan masalah yang mengalami regresi dan membuka kembali masalah tersebut.

Situasi ini dapat terjadi dalam situasi berikut: Anda telah memperbaiki bug dan merilis versi baru aplikasi, tetapi Anda masih memiliki pengguna di versi lama tanpa perbaikan bug. Jika, kebetulan, salah satu versi lama tersebut tidak pernah mengirim laporan error sama sekali saat Anda menutup masalah, dan pengguna tersebut mulai menemukan bug, maka laporan error tersebut akan memicu masalah yang mengalami regresi.

Jika Anda tidak ingin masalah dibuka kembali karena algoritma regresi kami, "nonaktifkan" masalah, bukan menutupnya.

Dengan melaporkan pengecualian yang tidak tertangkap sebagai fatal, Anda mendapatkan indikasi yang lebih realistis tentang pengecualian yang dapat menyebabkan game tidak dapat dimainkan, meskipun aplikasi terus berjalan.

Perhatikan bahwa jika Anda mulai melaporkan fatal, persentase pengguna bebas error (CFU) kemungkinan akan menurun, tetapi metrik CFU akan lebih mewakili pengalaman pengguna akhir dengan aplikasi Anda.

Agar Crashlytics dapat melaporkan pengecualian yang tidak tertangkap sebagai fatal, kedua kondisi berikut harus terpenuhi:

• Selama inisialisasi di aplikasi Anda, properti ReportUncaughtExceptionsAsFatal harus ditetapkan ke true.

• Aplikasi Anda (atau library yang disertakan) menampilkan pengecualian yang tidak tertangkap. Pengecualian yang dibuat, tetapi tidak ditampilkan, tidak dianggap tidak tertangkap.

Jika Anda mulai mendapatkan laporan pengecualian yang tidak tertangkap sebagai fatal, berikut adalah beberapa opsi untuk menangani pengecualian yang tidak tertangkap ini:

• Pertimbangkan cara untuk mulai menangkap dan menangani pengecualian yang tidak tertangkap ini.
• Pertimbangkan berbagai opsi untuk mencatat pengecualian ke dalam log di konsol debug Unity dan di Crashlytics.

Menangkap dan menangani pengecualian yang ditampilkan

Pengecualian dibuat dan ditampilkan untuk mencerminkan status yang tidak terduga atau luar biasa. Menyelesaikan masalah yang ditampilkan dari pengecualian yang ditampilkan melibatkan pengembalian program ke status yang diketahui (proses yang disebut dengan penanganan pengecualian).

Praktik terbaiknya adalah menangkap dan menangani semua pengecualian yang diperkirakan kecuali jika program tidak dapat dikembalikan ke status yang diketahui.

Untuk mengontrol jenis pengecualian yang ditangkap dan ditangani dengan suatu kode, gabungkan kode yang mungkin menghasilkan pengecualian dalam blok try-catch. Pastikan kondisi dalam pernyataan catch sudah sespesifik mungkin untuk menangani pengecualian spesifik dengan tepat.

Mencatat pengecualian ke dalam log di Unity atau Crashlytics

Ada beberapa cara untuk mencatat pengecualian ke dalam log di Unity atau Crashlytics untuk membantu men-debug masalah.

Saat menggunakan Crashlytics, berikut ini adalah dua opsi yang paling umum dan direkomendasikan:

• Opsi 1: Cetak di konsol Unity, tetapi jangan laporkan ke Crashlytics, selama pengembangan atau pemecahan masalah

  • Cetak di konsol Unity menggunakan Debug.Log(exception), Debug.LogWarning(exception), dan Debug.LogError(exception) yang mencetak konten pengecualian di konsol Unity dan tidak menampilkan ulang pengecualian.

• Opsi 2: Upload ke Crashlytics untuk pelaporan gabungan di dasbor Crashlytics untuk situasi berikut:

  • Jika ada pengecualian yang patut dicatat ke dalam log untuk men-debug kemungkinan peristiwa Crashlytics berikutnya, gunakan Crashlytics.Log(exception.ToString()).
  • Jika pengecualian tetap harus dilaporkan ke Crashlytics meskipun ditangkap dan ditangani, gunakan Crashlytics.LogException(exception) untuk mencatatnya ke dalam log sebagai peristiwa nonfatal.

Namun, jika ingin melaporkan peristiwa fatal ke Unity Cloud Diagnostik secara manual, Anda dapat menggunakan Debug.LogException. Opsi ini akan mencetak pengecualian di konsol Unity seperti Opsi 1, tetapi juga menampilkan pengecualian (terlepas dari apakah telah ditampilkan atau belum ditangkap). Error ini akan ditampilkan secara nonlokal. Ini berarti bahwa bahkan Debug.LogException(exception) di sekitarnya dengan blok try-catch tetap menghasilkan pengecualian yang tidak tertangkap.

Oleh karena itu, panggil Debug.LogException jika dan hanya jika Anda ingin melakukan semua hal berikut:

• Untuk mencetak pengecualian di konsol Unity.
• Untuk mengupload pengecualian ke Crashlytics sebagai peristiwa fatal.
• Untuk menampilkan pengecualian, biarkan pengecualian tersebut diperlakukan sebagai pengecualian yang tidak tertangkap, dan laporkan ke Diagnostik Unity Cloud.

Perhatikan bahwa jika Anda ingin mencetak pengecualian yang tertangkap di konsol Unity dan mengupload ke Crashlytics sebagai peristiwa nonfatal, lakukan hal berikut:

try
{
    methodThatThrowsMyCustomExceptionType();
}
catch(MyCustomExceptionType exception)
{
    // Print the exception to the Unity console at the error level.
    Debug.LogError(exception);
    // Upload the exception to Crashlytics as a non-fatal event.
    Crashlytics.LogException(exception); // not Debug.LogException
    //
    // Code that handles the exception
    //
}