Menyesuaikan agregasi data permintaan jaringan

Firebase Performance Monitoring otomatis menggabungkan data untuk permintaan jaringan yang mirip guna membantu Anda memahami tren dalam performa permintaan jaringan.

Namun, terkadang Anda perlu menyesuaikan cara Firebase menggabungkan data permintaan jaringan tertentu untuk mendukung kasus penggunaan aplikasi Anda dengan lebih baik. Kami menyediakan dua cara untuk menyesuaikan agregasi data untuk permintaan jaringan: menggabungkan data berdasarkan pola URL kustom dan menyesuaikan cara penghitungan tingkat keberhasilan.

Menggabungkan data berdasarkan pola URL kustom

Untuk setiap permintaan, Firebase akan memeriksa kecocokan URL permintaan jaringan dengan pola URL. Jika URL permintaan cocok dengan pola URL, Firebase akan otomatis menggabungkan data permintaan berdasarkan pola URL.

Anda dapat membuat pola URL kustom untuk memantau pola URL tertentu yang tidak diambil oleh Firebase menggunakan pencocokan pola URL otomatis miliknya. Sebagai contoh, Anda dapat menggunakan pola URL kustom untuk memecahkan masalah pada URL tertentu atau memantau serangkaian URL dari waktu ke waktu.

Firebase menampilkan semua pola URL (termasuk pola URL kustom) dan data gabungannya di subtab Network requests pada tabel trace, yang ada di bagian bawah dasbor Performance di Firebase console.

Bagaimana cara kerja pencocokan pola URL kustom?

Firebase akan mencoba mencocokkan URL permintaan dengan semua pola URL kustom yang telah dikonfigurasi sebelum kembali ke pencocokkan pola URL otomatis. Untuk semua permintaan pencocokan dengan pola URL kustom, Firebase menghimpun data permintaan berdasarkan pola URL kustom.

Jika URL permintaan cocok dengan lebih dari satu pola URL kustom, Firebase akan memetakan permintaan hanya ke pola URL kustom yang paling spesifik, menurut urutan kekhususan berikut ini: teks biasa > * > ** dari kiri ke kanan di jalur. Misalnya, permintaan untuk example.com/books/dog cocok dengan dua pola URL kustom:

• example.com/books/*
• example.com/*/dog

Namun, pola example.com/books/* adalah pola URL yang cocok yang paling spesifik karena segmen paling kiri books di example.com/books/* lebih diutamakan jika dibandingkan dengan segmen paling kiri * di example.com/*/dog.

Saat membuat pola URL kustom yang baru, perhatikan hal-hal berikut:

• Pola yang cocok dan data gabungan dari permintaan sebelumnya tidak dipengaruhi oleh pembuatan pola URL kustom yang baru. Firebase tidak menghimpun ulang data permintaan yang sudah lampau.

• Pola URL kustom yang baru hanya akan memengaruhi permintaan yang akan datang. Anda mungkin perlu menunggu hingga 12 jam agar Performance Monitoring dapat mengumpulkan dan menghimpun data berdasarkan pola URL kustom yang baru.

Membuat pola URL kustom

Anda dapat membuat pola URL kustom dari subtab Network requests pada tabel trace, yang ada di bagian bawah dasbor Performance di Firebase console.

Anggota project harus merupakan Pemilik atau Editor untuk membuat pola URL kustom yang baru. Namun, semua anggota project dapat melihat pola URL kustom dan data gabungannya.

Anda dapat membuat hingga total 400 pola URL kustom per aplikasi dan hingga 100 pola URL kustom per domain untuk aplikasi tersebut.

Untuk membuat pola URL kustom, mulailah dengan nama host, diikuti dengan segmen jalur. Nama host harus menyertakan domain yang valid, dan secara opsional dapat menyertakan subdomain. Gunakan sintaksis segmen jalur berikut untuk membuat pola yang dapat cocok dengan URL.

• teks biasa — cocok dengan string yang sama persis
• * — cocok dengan segmen subdomain pertama, atau string apa pun dalam segmen jalur tunggal
• ** — cocok dengan akhiran jalur sembarang

Tabel berikut menjelaskan beberapa kemungkinan pencocokan pola URL kustom.

Untuk dicocokkan dengan...	Buat pola URL kustom seperti...	Contoh kecocokan dengan pola URL ini
URL persis	example.com/foo/baz	example.com/foo/baz
Semua segmen berjalur tunggal (*)	example.com/*/baz	example.com/foo/baz example.com/bar/baz
	example.com/*/*/baz	example.com/foo/bar/baz example.com/bah/qux/baz
	example.com/foo/*	example.com/foo/baz example.com/foo/bar Catatan: Pola ini tidak akan cocok dengan example.com/foo.
Akhiran jalur sembarang (**)	example.com/foo/**	example.com/foo example.com/foo/baz example.com/foo/baz/more/segments
	subdomain.example.com/foo.bar/**	subdomain.example.com/foo.bar subdomain.example.com/foo.bar/baz subdomain.example.com/foo.bar/baz/more/segments
Segmen subdomain pertama (*)	*.example.com/foo	bar.example.com/foo baz.example.com/foo

Catatan: Untuk pola URL kustom, Firebase tidak mendukung sintaksis *.file-extension, seperti *.png atau *.css.

Melihat pola URL kustom dan datanya

Firebase menampilkan semua pola URL (termasuk pola URL kustom) dan data gabungannya di subtab Network requests pada tabel trace, yang ada di bagian bawah dasbor Performance di Firebase console.

Untuk melihat hanya pola URL kustom, pilih Custom patterns dari menu dropdown di subtab Network requests pada tabel trace. Perlu diperhatikan bahwa jika pola URL kustom tidak memiliki data gabungan, artinya pola tersebut hanya muncul dalam daftar ini.

Saat periode retensi data berakhir untuk data yang digabungkan berdasarkan pola URL, Firebase akan menghapus data tersebut dari pola URL tersebut. Jika masa berlaku semua data yang digabungkan berdasarkan pola URL kustom sudah habis, Firebase tidak akan menghapus pola URL kustom tersebut dari Firebase console. Sebagai gantinya, Firebase akan tetap mencantumkan pola URL kustom yang "kosong" di daftar Custom patterns di subtab Network requests pada tabel trace.

Menghapus pola URL kustom

Anda dapat menghapus pola URL kustom dari project Anda. Perlu diperhatikan bahwa Anda tidak dapat menghapus pola URL otomatis.

1. Dari dasbor Performance, scroll ke bawah ke tabel trace, lalu pilih subtab Network requests.

2. Pilih Custom patterns dari menu dropdown di subtab Network requests.

3. Arahkan kursor ke baris pola URL kustom yang ingin Anda hapus.

4. Klik di ujung kanan baris, pilih Remove custom pattern, lalu konfirmasi penghapusan pada dialog.

Saat menghapus pola URL kustom, perhatikan hal-hal berikut:

• Semua permintaan yang akan datang dipetakan ke pola URL kustom yang cocok berikutnya yang paling spesifik . Jika tidak berhasil menemukan pola URL kustom yang cocok, Firebase akan kembali lagi ke pencocokan pola URL otomatis.

• Pola yang cocok dan data gabungan dari permintaan sebelumnya tidak dipengaruhi oleh penghapusan pola URL kustom.

  Anda masih dapat mengakses pola URL kustom yang dihapus dan data gabungannya di subtab Network requests (dengan All network requests dipilih) hingga periode retensi data yang berlaku berakhir. Jika masa berlaku semua data gabungan berdasarkan pola URL kustom yang telah dihapus sudah habis, Firebase akan menghapus pola URL kustom tersebut.

• Subtab Network requests (dengan Custom patterns dipilih) tidak berisi pola URL kustom yang telah dihapus.

Langkah berikutnya

• Siapkan pemberitahuan untuk permintaan jaringan yang menurunkan performa aplikasi Anda. Misalnya, Anda dapat mengonfigurasi peringatan email untuk tim jika waktu respons untuk pola URL tertentu melebihi batas yang Anda tetapkan.

Menyesuaikan cara penghitungan tingkat keberhasilan

Salah satu metrik yang dipantau Firebase untuk setiap permintaan jaringan adalah tingkat keberhasilan permintaan. Tingkat keberhasilan adalah persentase respons yang berhasil dibandingkan dengan total respons. Metrik ini membantu Anda mengukur kegagalan jaringan dan server.

Secara khusus, Firebase otomatis menghitung permintaan jaringan dengan kode respons dalam rentang 100 - 399 sebagai respons yang berhasil.

Anda dapat menyesuaikan penghitungan tingkat keberhasilan dengan menghitung kode error tertentu sebagai "respons yang berhasil" selain kode respons yang secara otomatis dihitung Firebase berhasil.

Misalnya, jika aplikasi Anda memiliki API endpoint penelusuran, Anda dapat menghitung respons 404 sebagai "berhasil" karena respons 404 diharapkan untuk endpoint penelusuran. Misalnya ada 100 sampel untuk endpoint penelusuran ini setiap jam, dan 60 di antaranya adalah 200 respons, dan 40 di antaranya adalah respons 404. Sebelum Anda mengonfigurasi tingkat keberhasilan, tingkat keberhasilannya adalah 60%. Setelah Anda mengonfigurasi penghitungan tingkat keberhasilan untuk menghitung respons 404 sebagai berhasil, tingkat keberhasilannya adalah 100%.

Catatan: Konfigurasi tingkat keberhasilan baru hanya berlaku untuk data yang dikumpulkan setelah konfigurasi dibuat.

Mengonfigurasi penghitungan tingkat keberhasilan

Untuk mengonfigurasi penghitungan tingkat keberhasilan untuk pola URL jaringan, 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.

1. Buka tab Dashboard pada Performance Monitoring di Firebase console, lalu pilih aplikasi yang penghitungan tingkat keberhasilannya ingin dikonfigurasi.
2. Scroll ke bawah ke tabel trace di bagian bawah layar, lalu pilih tab Network requests.
3. Temukan pola URL yang penghitungan tingkat keberhasilannya ingin dikonfigurasi.
4. Di ujung kanan baris, buka menu tambahan () lalu pilih Configure success rate.
5. Ikuti petunjuk di layar untuk memilih kode respons yang ingin Anda hitung sebagai kode respons yang berhasil.

Catatan: Anda dapat mengonfigurasi tingkat keberhasilan untuk pola URL otomatis dan kustom. Sebaiknya Anda hanya mengonfigurasi tingkat keberhasilan untuk pola URL kustom karena pola URL otomatis dapat berubah seiring waktu saat data Anda berubah.