Menyesuaikan pemberitahuan kecepatan

Gunakan pemberitahuan kecepatan untuk memberi tahu tim Anda saat suatu masalah tertentu menyebabkan masalah yang mendesak di aplikasi Anda. Untuk Crashlytics, masalah diartikan sebagai sekelompok error atau peristiwa aplikasi tidak merespons (ANR) yang mirip.

Hal yang memicu pemberitahuan

Pemberitahuan kecepatan dipicu saat masalah di aplikasi Anda melampaui batas tertentu yang Anda konfigurasi di konsol Firebase.

Anda menentukan batas untuk pemberitahuan kecepatan dalam hal persentase pengguna dan jumlah minimum pengguna yang terkena dampak error atau ANR. Anda dapat menetapkan batas persentase antara 0% dan 100% dari sesi. Batas pengguna minimum dapat disetel ke angka berapa pun yang lebih besar dari atau sama dengan 10. Secara default, batas pemberitahuan kecepatan ditetapkan 1% dari sesi dan 25 pengguna.

Secara khusus, pemberitahuan akan dipicu jika, dalam jangka waktu 30 menit, semua hal berikut terjadi:

  • Terjadi masalah dalam aplikasi yang melampaui batas persentase yang ditetapkan dan melampaui jumlah minimum pengguna yang ditetapkan untuk aplikasi tersebut.
  • Aplikasi memiliki setidaknya 10 pengguna dalam jangka waktu tersebut.
  • Sebelumnya tidak ada pemberitahuan yang dilaporkan untuk masalah tersebut dalam aplikasi pada versi itu.

Mengonfigurasi batas pemberitahuan kecepatan

Untuk mengonfigurasi batas pemberitahuan kecepatan, Anda harus memiliki izin firebasecrashlytics.config.update. Peran berikut menyertakan izin yang diperlukan ini secara default: Firebase Crashlytics Admin, Firebase Quality Admin, Firebase Admin, atau Pemilik atau Editor project.

Konfigurasi batas pemberitahuan kecepatan untuk setiap aplikasi Anda yang terdaftar. Setiap aplikasi dapat memiliki nilai minimum pemberitahuan yang berbeda.

  1. Login ke konsol Firebase, lalu pilih project Anda.

  2. Klik , lalu pilih Project Settings. Pilih tab Alerts.

  3. Buka kartu pemberitahuan Crashlytics, lalu pilih tab Velocity Alerts.

  4. Konfigurasi batas pemberitahuan untuk aplikasi.

Menerima pemberitahuan

Mendapatkan pemberitahuan default

Secara default, Firebase dapat mengirimkan pemberitahuan Crashlytics menggunakan email. Untuk pemberitahuan dan regresi kecepatan, Firebase juga dapat menampilkan pemberitahuan ini di Firebase console.

Untuk menerima pemberitahuan Crashlytics menggunakan mekanisme default ini, Anda harus memiliki izin firebase.projects.update. Peran berikut mencakup izin yang diperlukan ini secara default: Firebase Admin atau Owner atau Editor project.

Secara default, setiap anggota project (yang memiliki izin yang diperlukan untuk menerima pemberitahuan) akan mendapatkan email saat pemberitahuan dari Crashlytics dipicu.

Mengaktifkan atau menonaktifkan pemberitahuan untuk akun Anda

Anda dapat mengaktifkan atau menonaktifkan pemberitahuan Crashlytics untuk akun Anda tanpa memengaruhi anggota project lainnya. Perlu diperhatikan bahwa Anda masih memerlukan izin yang dibutuhkan untuk menerima pemberitahuan.

  1. Login ke konsol Firebase, lalu pilih project Anda.

  2. Klik , lalu pilih Project Settings. Pilih tab Alerts.

  3. Buka kartu pemberitahuan Crashlytics, lalu pilih tab Velocity Alerts.

  4. Tetapkan preferensi akun Anda untuk pemberitahuan Crashlytics.

Menyiapkan pemberitahuan dasar ke layanan pihak ketiga

Untuk pemberitahuan Crashlytics, Firebase menawarkan mekanisme untuk mengirim pemberitahuan ke layanan pihak ketiga berikut: Slack, Jira, atau PagerDuty.

  1. Siapkan opsi pemberitahuan dasar ini menggunakan alur kerja terpandu di tab Integrations di Project settings Anda.

  2. Pilih konfigurasi yang digunakan untuk setiap aplikasi dan konfigurasi tujuan pemberitahuan lainnya di kartu Crashlytics pada tab Alerts di Project settings Anda.

Perhatikan bahwa jika Anda ingin lebih leluasa dalam mengontrol dan menyesuaikan pengiriman pemberitahuan ke layanan pihak ketiga (tidak terbatas hanya pada Slack, Jira, atau PagerDuty), lihat bagian Menyiapkan pemberitahuan lanjutan ke layanan pihak ketiga yang menjelaskan opsi pemberitahuan lanjutan.

Menyiapkan pemberitahuan lanjutan untuk layanan pihak ketiga

Anda dapat mengirim pemberitahuan Crashlytics ke saluran notifikasi pilihan tim Anda, menggunakan Cloud Functions for Firebase. Misalnya, Anda dapat menulis fungsi yang menangkap peristiwa pemberitahuan untuk pemberitahuan kecepatan dan memposting informasi pemberitahuan tersebut ke layanan pihak ketiga, seperti Discord, Slack, atau Jira. Dengan mekanisme pemberitahuan lanjutan ini, Anda dapat menyesuaikan sepenuhnya informasi yang dikirim ke layanan pihak ketiga. Misalnya, Anda dapat menyertakan deep link berguna ke Firebase console atau menambahkan informasi pemecahan masalah spesifik per perusahaan.

Untuk menyiapkan kemampuan pemberitahuan lanjutan menggunakan Cloud Functions for Firebase, ikuti langkah-langkah berikut:

  1. Siapkan Cloud Functions for Firebase, yang mencakup tugas berikut:

    1. Menyiapkan lingkungan pengembangan untuk Node.js atau Python.
    2. Menginstal dan login ke Firebase CLI.
    3. Melakukan inisialisasi Cloud Functions for Firebase menggunakan CLI Firebase.

  2. Menulis dan men-deploy fungsi yang menangkap peristiwa pemberitahuan dari Crashlytics dan menangani payload peristiwa (misalnya memposting informasi pemberitahuan dalam pesan di Discord).

Untuk mempelajari semua peristiwa pemberitahuan Crashlytics yang dapat Anda tangkap, buka dokumentasi referensi untuk pemberitahuan Crashlytics.