Menyiapkan pemberitahuan untuk masalah performa

Jika perubahan kode atau permintaan jaringan menurunkan performa aplikasi Anda, gunakan pemberitahuan Performance Monitoring untuk memberi tahu anggota project.

Anda dapat menyiapkan dan menyesuaikan pemberitahuan untuk aplikasi, yang akan memberi tahu Anda saat performa suatu peristiwa melampaui batas yang ditetapkan.

Hal yang memicu pemberitahuan

Pemberitahuan akan dipicu saat metrik untuk aplikasi Anda melampaui batas yang ditentukan untuk persentil tertentu (jika berlaku) di Firebase console. Pemberitahuan hanya dipicu jika aplikasi Anda menggunakan versi SDK yang kompatibel secara real time.

waktu mulai aplikasi

Jika Anda mengonfigurasi pemberitahuan untuk waktu mulai aplikasi, pemberitahuan akan dipicu saat semua kondisi berikut terpenuhi:

  • Firebase mencatat setidaknya 100 sampel trace _app_start untuk versi terbaru aplikasi Anda dalam satu jam terakhir.
  • Durasi trace _app_start melampaui batas yang ditentukan aplikasi selama satu jam terakhir dan untuk persentil yang dikonfigurasi.
  • Sebelumnya tidak ada pemberitahuan yang dilaporkan untuk batas yang sama pada versi terbaru aplikasi Anda.

trace kode kustom

Jika Anda mengonfigurasi pemberitahuan untuk metrik trace kode kustom, pemberitahuan akan dipicu saat semua kondisi berikut terpenuhi:

  • Firebase mencatat setidaknya 100 sampel trace kode kustom untuk versi terbaru aplikasi Anda dalam satu jam terakhir.
  • Durasi trace melampaui batas yang ditentukan aplikasi selama satu jam terakhir dan untuk persentil yang dikonfigurasi.
  • (Khusus iOS+ dan Android) Sebelumnya tidak ada pemberitahuan yang dilaporkan untuk batas yang sama pada versi terbaru aplikasi Anda.
  • (Khusus web) Sebelumnya tidak ada pemberitahuan yang dilaporkan untuk batas yang sama dalam 3 hari terakhir.

permintaan jaringan

Jika Anda mengonfigurasi pemberitahuan untuk metrik permintaan jaringan, pemberitahuan akan dipicu saat semua kondisi berikut terpenuhi:

  • Firebase mencatat setidaknya 100 sampel yang cocok dengan pola URL di semua versi aplikasi Anda dalam satu jam terakhir.
  • Nilai gabungan metrik melampaui batas yang ditentukan selama satu jam terakhir:
    • response time: nilai gabungan melampaui batas yang ditetapkan untuk persentil yang dikonfigurasi
    • success rate: (khusus iOS+/Android) nilai gabungan berada di bawah batas yang ditetapkan untuk seluruh pengguna
  • Sebelumnya tidak ada pemberitahuan yang dilaporkan untuk batas yang sama dalam 3 hari terakhir.

rendering layar

Jika Anda mengonfigurasi pemberitahuan untuk metrik rendering layar, pemberitahuan akan dipicu saat semua kondisi berikut terpenuhi:

  • Firebase mencatat setidaknya 100 sampel rendering layar untuk versi terbaru aplikasi Anda dalam satu jam terakhir.
  • Nilai gabungan metrik melampaui batas yang ditentukan selama satu jam terakhir:
    • frozen frames: nilai gabungan melampaui batas yang ditetapkan
    • slow frames: nilai gabungan melampaui batas yang ditetapkan
  • Sebelumnya tidak ada pemberitahuan yang dilaporkan untuk batas yang sama pada versi terbaru aplikasi Anda.

pemuatan halaman

Jika Anda mengonfigurasi pemberitahuan untuk metrik pemuatan halaman, pemberitahuan akan dipicu saat semua kondisi berikut terpenuhi:

  • Firebase mencatat setidaknya 100 sampel pemuatan halaman untuk aplikasi Anda dalam satu jam terakhir.
  • Nilai gabungan metrik melampaui batas yang ditentukan selama satu jam terakhir dan untuk persentil yang dikonfigurasi:
    • first input delay: nilai gabungan melampaui batas yang ditetapkan dan persentil yang dikonfigurasi
    • first contentful paint: nilai gabungan melampaui batas yang ditetapkan dan persentil yang dikonfigurasi
    • first paint: nilai gabungan melampaui batas yang ditetapkan dan persentil yang dikonfigurasi
  • Sebelumnya tidak ada pemberitahuan yang dilaporkan untuk batas yang sama dalam 3 hari terakhir.

Pelajari lebih lanjut cara mengonfigurasi pemberitahuan, persentil default, dan praktik terbaik untuk menyiapkan pemberitahuan untuk jenis trace dan metrik tertentu.

Pemberitahuan untuk metrik performa lainnya atau untuk integrasi Firebase bawaan dengan Slack, Jira, dan PagerDuty tidak tersedia untuk pemberitahuan Performance Monitoring.

Menerima pemberitahuan

Mendapatkan pemberitahuan default

Secara default, Firebase dapat mengirimkan pemberitahuan Performance Monitoring melalui email.

Untuk menerima pemberitahuan Performance Monitoring melalui mekanisme default ini, Anda harus memiliki izin firebaseperformance.config.update. Izin ini dicakup secara default oleh peran berikut:

Pemberitahuan dan setelannya berlaku di seluruh project. Artinya, secara default, setiap anggota project (yang bukan grup email dan memiliki izin yang diperlukan untuk menerima pemberitahuan) akan menerima email saat notifikasi performa aplikasi dipicu.

Mengaktifkan/menonaktifkan pemberitahuan untuk akun Anda

Anda dapat mengaktifkan/menonaktifkan pemberitahuan Performance Monitoring untuk akun sendiri tanpa memengaruhi anggota project lainnya. Perlu diperhatikan bahwa Anda masih memerlukan izin yang dibutuhkan untuk menerima pemberitahuan.

Untuk mengaktifkan atau menonaktifkan pemberitahuan Performance Monitoring, ikuti langkah-langkah berikut:

  1. Di Firebase console, di pojok kanan atas, buka Firebase alerts.
  2. Kemudian, buka Settings dan tetapkan preferensi akun Anda untuk pemberitahuan Performance Monitoring.

Menyiapkan pemberitahuan lanjutan untuk layanan pihak ketiga

Anda juga dapat mengirim pemberitahuan Performance Monitoring ke saluran notifikasi pilihan tim Anda, menggunakan Cloud Functions for Firebase. Misalnya, Anda dapat menulis fungsi yang menangkap peristiwa pemberitahuan untuk waktu mulai aplikasi yang lambat dan memposting informasi pemberitahuan ke layanan pihak ketiga, seperti Discord, Slack, atau Jira.

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 Firebase CLI.
  2. Menulis dan men-deploy fungsi yang menangkap peristiwa pemberitahuan dari Performance Monitoring dan menangani payload peristiwa (misalnya, memposting informasi pemberitahuan dalam pesan di Discord).

Untuk mempelajari semua peristiwa notifikasi performa aplikasi yang dapat Anda tangkap, buka dokumentasi referensi untuk pemberitahuan Performance Monitoring.

Penghapusan otomatis pemberitahuan tidak valid

Performance Monitoring memvalidasi pemberitahuan untuk memastikan data valid dan pemberitahuan digunakan secara aktif. Pemberitahuan dianggap valid jika salah satu kondisi berikut terpenuhi:

  • Pemberitahuan dibuat untuk ID Resource yang data Performance Monitoring-nya diterima dalam 90 hari terakhir.
  • Pemberitahuan baru saja dibuat untuk pola URL kustom. Setelah membuat pola URL kustom dan menyiapkan pemberitahuan, Anda memiliki waktu 90 hari untuk mengirim data untuk pola tersebut. Jika tidak ada data yang dikirim dalam jangka waktu 90 hari, Performance Monitoring akan menghapus pemberitahuan tersebut. Untuk informasi selengkapnya tentang pola URL kustom, baca Data gabungan berdasarkan pola URL pelanggan.

Jika salah satu kondisi tersebut tidak terpenuhi, Performance Monitoring akan menghapus pemberitahuan.

Mengonfigurasi pemberitahuan

Untuk mengonfigurasi pemberitahuan Performance Monitoring, Anda harus memiliki izin firebaseperformance.config.update. Izin ini dicakup secara default oleh peran berikut: Firebase Performance Admin, Firebase Quality Admin, Firebase Admin, dan Pemilik atau Editor project.

Jika Anda belum melakukannya, tambahkan Performance Monitoring SDK terbaru ke aplikasi Anda. Untuk mengetahui informasi selengkapnya, lihat panduan memulai untuk platform web, Android, Apple, dan Flutter.

Di setiap aplikasi Anda yang terdaftar, gunakan tabel Traces atau kartu laporan Dashboard untuk mengonfigurasi pemberitahuan bagi setiap metrik yang ingin dipantau. Setiap aplikasi dapat memiliki serangkaian pemberitahuan yang berbeda, masing-masing dengan batas yang berbeda (atau tidak memiliki pemberitahuan sama sekali).

Mengonfigurasi pemberitahuan di tabel Traces

  1. Buka tab Dashboard pada Performance Monitoring di Firebase console, lalu pilih aplikasi yang pemberitahuannya ingin dikonfigurasi.

  2. Scroll ke tabel Traces di bagian bawah layar.

  3. Pilih tab jenis trace yang pemberitahuannya ingin Anda siapkan, lalu temukan baris yang berlaku.

  4. Di ujung kanan baris, buka Menu Tambahan (), lalu pilih Alert settings.

  5. Ikuti petunjuk di layar guna menetapkan batas pemberitahuan dan persentil (jika berlaku) untuk aplikasi, atau untuk mengaktifkan/menonaktifkan pemberitahuan. Persentil default adalah ke-90 untuk Android dan iOS, dan ke-75 untuk Web. Untuk mempelajari persentil default lebih lanjut, baca bagian Melacak metrik utama di dasbor.

Mengonfigurasi pemberitahuan di kartu laporan Dashboard

  1. Buka tab Dashboard pada Performance Monitoring di Firebase console, lalu pilih aplikasi yang pemberitahuannya ingin dikonfigurasi.

  2. Di tab Report card, temukan kartu metrik yang pemberitahuannya ingin dikonfigurasi.

  3. Di kartu metrik yang diinginkan, buka Menu Tambahan (), lalu pilih Alert settings.

  4. Ikuti petunjuk di layar guna menetapkan batas pemberitahuan dan persentil (jika berlaku) untuk aplikasi, atau untuk mengaktifkan/menonaktifkan pemberitahuan. Persentil default adalah ke-90 untuk Android dan iOS, dan ke-75 untuk Web. Untuk mempelajari persentil default lebih lanjut, baca bagian Melacak metrik utama di dasbor.

Praktik terbaik untuk menyiapkan notifikasi performa aplikasi

Permintaan jaringan

Firebase menggabungkan data dari permintaan jaringan yang mirip berdasarkan pola URL, yang dapat berupa salah satu pola berikut:

  • Pola yang ditentukan pengguna, yang disebut pola URL kustom.

  • Pola yang berasal dari Firebase, yang disebut pola URL otomatis.
    Pola ini dapat berubah seiring waktu berdasarkan perilaku penggunaan terbaru aplikasi Anda.

Menyiapkan pemberitahuan untuk pola URL kustom

Sebaiknya siapkan pemberitahuan untuk setiap pola URL kustom yang telah Anda konfigurasikan. Karena Firebase berusaha mencocokkan permintaan dengan pola URL kustom terlebih dahulu, permintaan serupa akan lebih konsisten dipetakan ke pola URL yang sama. Hal ini membuat pemberitahuan untuk pola URL kustom lebih bermakna dan efektif bagi tim Anda, karena Anda telah menetapkan bahwa pola permintaan tertentu tersebut penting bagi aplikasi Anda.

Menyiapkan pemberitahuan untuk pola URL otomatis

Saat menyiapkan pemberitahuan untuk pola URL otomatis, pastikan pola URL otomatis telah stabil selama beberapa hari. Perlu diingat bahwa pola URL otomatis dapat berubah dari waktu ke waktu, dan konfigurasi pemberitahuan tidak ikut diterapkan ke pola URL baru. Hal ini dapat menyebabkan pemberitahuan yang salah atau hilang untuk pola yang penting bagi Anda. Anda juga dapat mempertimbangkan untuk membuat pola URL kustom guna memastikan bahwa pola ini stabil.

Pemuatan halaman web

Untuk mempelajari batas yang direkomendasikan dalam mengukur metrik web, lihat dokumentasi Core Web Vitals.

Rendering layar

Untuk memastikan pengalaman aplikasi yang optimal, tidak boleh ada periode frozen dan periode lambat pada sesi pengguna. Performance Monitoring merekomendasikan agar Anda menyiapkan pemberitahuan untuk periode frozen yang lebih besar dari 1% dan untuk periode lambat yang melampaui 5%. Anda akan mendapati bahwa nilai tersebut merupakan setelan default selama konfigurasi notifikasi performa aplikasi. Untuk mempelajari lebih lanjut periode lambat atau periode frozen yang berlebihan dan praktik terbaik untuk performa aplikasi lainnya, lihat panduan Google Play.