Siapkan peringatan untuk masalah kinerja

Gunakan peringatan Performance Monitoring untuk memberi tahu anggota proyek jika perubahan kode atau permintaan jaringan menurunkan kinerja aplikasi Anda.

Apa yang memicu peringatan?

Peringatan dipicu saat metrik tertentu untuk aplikasi Anda melewati ambang batas yang Anda tetapkan di Firebase console. Lansiran dipicu hanya jika aplikasi Anda menggunakan versi SDK yang kompatibel secara real-time .

permintaan jaringan

Jika Anda mengonfigurasi lansiran untuk metrik permintaan jaringan, lansiran akan dipicu jika semua kondisi berikut ini benar:

  • Firebase mencatat setidaknya 100 sampel yang cocok dengan pola URL (di semua versi aplikasi Anda dalam satu jam terakhir).
  • Nilai gabungan metrik melewati ambang batas yang ditentukan (selama satu jam terakhir):

    • waktu respons : nilai gabungan melebihi ambang batas yang ditetapkan (untuk persentil ke-50 pengguna)
    • tingkat keberhasilan : (hanya untuk iOS+/Android) nilai agregat berada di bawah ambang batas yang ditetapkan (di semua pengguna)
  • Tidak ada lansiran yang sebelumnya dinaikkan untuk ambang yang sama (dalam 3 hari terakhir ).

waktu mulai aplikasi

Jika Anda mengonfigurasi lansiran untuk waktu mulai aplikasi, lansiran akan dipicu jika semua kondisi berikut ini benar:

  • Firebase mencatat setidaknya 100 sampel jejak _app_start (untuk versi terbaru aplikasi Anda dalam satu jam terakhir).
  • Durasi _app_start trace melebihi ambang batas yang ditentukan aplikasi (selama satu jam terakhir dan untuk persentil ke-50 pengguna).
  • Tidak ada lansiran yang sebelumnya dinaikkan untuk ambang yang sama (dalam versi aplikasi terbaru Anda).

jejak kode khusus

Jika Anda mengonfigurasi lansiran untuk metrik pelacakan kode khusus, lansiran akan dipicu jika semua kondisi berikut benar:

  • Firebase mencatat setidaknya 100 sampel pelacakan kode kustom (untuk versi terbaru aplikasi Anda dalam satu jam terakhir).
  • Durasi pelacakan melebihi ambang batas yang ditentukan aplikasi (selama satu jam terakhir dan untuk persentil ke-50 pengguna).
  • Tidak ada lansiran yang sebelumnya dinaikkan untuk ambang yang sama (dalam versi aplikasi terbaru Anda).

pemuatan halaman

Jika Anda mengonfigurasi lansiran untuk metrik pemuatan laman, lansiran akan dipicu jika semua kondisi berikut benar:

  • Firebase mencatat setidaknya 100 contoh pemuatan halaman (untuk aplikasi Anda dalam satu jam terakhir).
  • Nilai gabungan metrik melewati ambang batas yang ditentukan (selama satu jam terakhir dan untuk persentil ke-50 pengguna):
    • penundaan input pertama : nilai agregat melebihi ambang batas yang ditetapkan
    • cat puas pertama : nilai agregat melebihi ambang batas yang ditetapkan
  • Tidak ada lansiran yang sebelumnya dinaikkan untuk ambang yang sama (dalam 3 hari terakhir ).

Nanti di halaman ini, pelajari lebih lanjut tentang mengonfigurasi lansiran serta beberapa praktik terbaik untuk menyiapkan lansiran untuk jenis pelacakan dan metrik tertentu.

Perhatikan bahwa, saat ini, lansiran untuk metrik kinerja lain atau untuk integrasi Firebase bawaan dengan Slack , Jira , dan PagerDuty tidak tersedia untuk lansiran Performance Monitoring.

Terima peringatan

Peringatan Pemantauan Kinerja dikirim melalui pemberitahuan email.

Untuk menerima peringatan Performance Monitoring, Anda harus memiliki izin firebaseperformance.config.update . Peran berikut menyertakan izin yang diperlukan ini secara default: Firebase Performance Admin , Firebase Quality Admin , Firebase Admin , dan Project Owner atau Editor .

Lansiran dan pengaturannya berlaku untuk seluruh proyek. Ini berarti bahwa, secara default, setiap anggota proyek (yang memiliki izin yang diperlukan untuk menerima peringatan) akan mendapatkan pemberitahuan email saat peringatan dipicu.

Aktifkan/nonaktifkan peringatan untuk akun Anda sendiri

Untuk akun Anda sendiri, Anda dapat mengaktifkan/menonaktifkan peringatan Performance Monitoring tanpa mempengaruhi anggota proyek lainnya. Perhatikan bahwa Anda masih memerlukan izin yang diperlukan untuk menerima peringatan.

Di Firebase console, di pojok kanan atas, buka Firebase alerts > Settings , lalu setel preferensi akun Anda untuk notifikasi Performance Monitoring.

Konfigurasikan peringatan

Untuk mengonfigurasi peringatan Performance Monitoring, Anda harus memiliki izin firebaseperformance.config.update . Peran berikut menyertakan izin yang diperlukan ini secara default: Firebase Performance Admin , Firebase Quality Admin , Firebase Admin , dan Project Owner atau Editor .

Di setiap aplikasi terdaftar Anda, konfigurasikan peringatan untuk setiap metrik yang ingin Anda pantau dengan cermat. Setiap aplikasi dapat memiliki kumpulan peringatan yang berbeda, masing-masing dengan ambang batas yang berbeda (atau tidak memiliki peringatan sama sekali).

  1. Buka tab Performance Monitoring Dashboard di Firebase console, lalu pilih aplikasi yang ingin Anda konfigurasikan peringatannya.

  2. Gulir ke bawah ke tabel jejak di bagian bawah layar.

  3. Pilih tab tipe pelacakan yang ingin Anda atur peringatannya, lalu temukan baris yang berlaku.

    Perhatikan bahwa _app_start trace bersarang di tab Custom traces .

  4. Di ujung kanan baris, buka menu luapan ( ), lalu pilih Pengaturan lansiran .

  5. Ikuti petunjuk di layar untuk menyetel ambang batas peringatan untuk aplikasi atau untuk mengaktifkan/menonaktifkan peringatan.

Praktik terbaik untuk menyetel peringatan kinerja

Permintaan jaringan

Firebase menggabungkan data dari permintaan jaringan serupa di bawah pola URL, yang dapat berupa salah satu dari berikut ini:

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

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

Siapkan lansiran untuk pola URL khusus Anda

Sebaiknya siapkan lansiran untuk setiap pola URL khusus yang telah Anda konfigurasikan. Karena Firebase mencoba mencocokkan permintaan dengan pola URL khusus terlebih dahulu, permintaan serupa akan lebih konsisten dipetakan ke pola URL yang sama. Hal ini membuat lansiran untuk pola URL khusus lebih bermakna dan efektif bagi tim Anda, karena Anda telah mengidentifikasi pola permintaan tertentu itu sebagai hal yang penting bagi aplikasi Anda.

Siapkan peringatan untuk pola URL otomatis

Saat menyiapkan lansiran untuk pola URL otomatis, pastikan bahwa pola URL otomatis telah stabil selama beberapa hari. Ingatlah bahwa pola URL otomatis dapat berubah dari waktu ke waktu, dan konfigurasi lansiran tidak terbawa ke pola URL baru. Hal ini dapat mengakibatkan peringatan yang salah atau hilang untuk pola yang Anda pedulikan. Anda juga dapat mempertimbangkan untuk membuat pola URL khusus untuk memastikan bahwa pola ini stabil.

Pemuatan halaman web

Untuk mempelajari ambang batas yang disarankan untuk mengukur metrik web, lihat dokumentasi Data Web Inti .