Sebelum kamu memulai
Jika Anda belum melakukannya, tambahkan Firebase ke proyek Android Anda .
Langkah 1 : Tambahkan Performance Monitoring SDK ke aplikasi Anda
Setelah Anda menambahkan Performance Monitoring SDK, Firebase otomatis mulai mengumpulkan data untuk perenderan layar aplikasi Anda dan data yang terkait dengan siklus hidup aplikasi Anda (seperti waktu mulai aplikasi ). Agar Firebase dapat memantau permintaan jaringan, Anda juga harus menambahkan plugin Performance Monitoring Gradle (langkah berikutnya).
Dalam file Gradle modul (level aplikasi) Anda (biasanya
<project>/<app-module>/build.gradle
), tambahkan dependensi untuk library Android Performance Monitoring. Kami merekomendasikan penggunaan Firebase Android BoM untuk mengontrol pembuatan versi library.Kotlin+KTX
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:31.2.0') // Add the dependency for the Performance Monitoring library // When using the BoM, you don't specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-perf-ktx' }
Dengan menggunakan Firebase Android BoM , aplikasi Anda akan selalu menggunakan versi pustaka Android Firebase yang kompatibel.
(Alternatif) Tambahkan dependensi library Firebase tanpa menggunakan BoM
Jika Anda memilih untuk tidak menggunakan Firebase BoM, Anda harus menentukan setiap versi pustaka Firebase di baris dependensinya.
Perhatikan bahwa jika Anda menggunakan beberapa pustaka Firebase di aplikasi Anda, kami sangat menyarankan penggunaan BoM untuk mengelola versi pustaka, yang memastikan bahwa semua versi kompatibel.
dependencies { // Add the dependency for the Performance Monitoring library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-perf-ktx:20.3.1' }
Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:31.2.0') // Add the dependency for the Performance Monitoring library // When using the BoM, you don't specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-perf' }
Dengan menggunakan Firebase Android BoM , aplikasi Anda akan selalu menggunakan versi pustaka Android Firebase yang kompatibel.
(Alternatif) Tambahkan dependensi library Firebase tanpa menggunakan BoM
Jika Anda memilih untuk tidak menggunakan Firebase BoM, Anda harus menentukan setiap versi pustaka Firebase di baris dependensinya.
Perhatikan bahwa jika Anda menggunakan beberapa pustaka Firebase di aplikasi Anda, kami sangat menyarankan penggunaan BoM untuk mengelola versi pustaka, yang memastikan bahwa semua versi kompatibel.
dependencies { // Add the dependency for the Performance Monitoring library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-perf:20.3.1' }
Kompilasi ulang aplikasi Anda.
Langkah 2 : Tambahkan plugin Gradle Performance Monitoring ke aplikasi Anda
Setelah Anda menambahkan plugin Performance Monitoring Gradle, Firebase otomatis mulai mengumpulkan data untuk permintaan jaringan HTTP/S . Plugin ini juga memungkinkan Anda untuk melengkapi pelacakan kode khusus menggunakan anotasi @AddTrace .
Di file Gradle level root (level proyek) Anda (
<project>/build.gradle
), tambahkan plugin Performance Monitoring Gradle sebagai dependensi buildscript:buildscript { repositories { // Make sure that you have the following two repositories google() // Google's Maven repository mavenCentral() // Maven Central repository } dependencies { ... // To benefit from the latest Performance Monitoring plugin features, // update your Android Gradle plugin dependency to at least v3.4.0 classpath 'com.android.tools.build:gradle:7.2.0' // Make sure that you have the Google services Gradle plugin dependency classpath 'com.google.gms:google-services:4.3.15' // Add the dependency for the Performance Monitoring Gradle plugin classpath 'com.google.firebase:perf-plugin:1.4.2' } }
Dalam file Gradle modul (level aplikasi) Anda (biasanya
<project>/<app-module>/build.gradle
), tambahkan plugin Gradle Pemantauan Kinerja:plugins { id 'com.android.application' // Make sure that you have the Google services Gradle plugin id 'com.google.gms.google-services' // Add the Performance Monitoring Gradle plugin id 'com.google.firebase.firebase-perf' ... }
Kompilasi ulang aplikasi Anda.
Langkah 3 : Hasilkan peristiwa kinerja untuk tampilan data awal
Firebase mulai memproses peristiwa saat Anda berhasil menambahkan SDK ke aplikasi Anda. Jika Anda masih mengembangkan secara lokal, berinteraksilah dengan aplikasi Anda untuk menghasilkan peristiwa untuk pengumpulan dan pemrosesan data awal.
Hasilkan peristiwa dengan mengalihkan aplikasi Anda antara latar belakang dan latar depan beberapa kali, berinteraksi dengan aplikasi Anda dengan menavigasi melintasi layar, dan/atau memicu permintaan jaringan.
Buka dasbor Performa konsol Firebase. Anda akan melihat tampilan data awal Anda dalam beberapa menit.
Jika Anda tidak melihat tampilan data awal Anda, tinjau tips pemecahan masalah .
Langkah 4 : (Opsional) Lihat pesan log untuk peristiwa kinerja
Aktifkan logging debug untuk Performance Monitoring pada waktu pembuatan dengan menambahkan elemen
<meta-data>
ke fileAndroidManifest.xml
aplikasi Anda, seperti:<application> <meta-data android:name="firebase_performance_logcat_enabled" android:value="true" /> </application>
Periksa pesan log Anda untuk setiap pesan kesalahan.
Performance Monitoring menandai pesan lognya dengan
FirebasePerformance
. Dengan menggunakan pemfilteran logcat, Anda dapat secara khusus melihat pelacakan durasi dan pembuatan log permintaan jaringan HTTP/S dengan menjalankan perintah berikut:adb logcat -s FirebasePerformance
Periksa jenis log berikut yang menunjukkan bahwa Performance Monitoring mencatat peristiwa kinerja:
-
Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
-
Logging network request trace: URL
-
Klik URL untuk melihat data Anda di konsol Firebase. Mungkin perlu beberapa saat untuk memperbarui data di dasbor.
Jika aplikasi Anda tidak mencatat peristiwa kinerja, tinjau tips pemecahan masalah .
Langkah 5 : (Opsional) Tambahkan pemantauan khusus untuk kode tertentu
Untuk memantau data kinerja yang terkait dengan kode tertentu di aplikasi, Anda dapat melengkapi pelacakan kode khusus .
Dengan pelacakan kode khusus, Anda dapat mengukur berapa lama waktu yang dibutuhkan aplikasi untuk menyelesaikan tugas atau kumpulan tugas tertentu, seperti memuat kumpulan gambar atau membuat kueri database Anda. Metrik default untuk pelacakan kode khusus adalah durasinya, tetapi Anda juga dapat menambahkan metrik khusus, seperti cache hits dan peringatan memori.
Dalam kode Anda, Anda menentukan awal dan akhir pelacakan kode khusus (dan menambahkan metrik khusus yang diinginkan) menggunakan API yang disediakan oleh Performance Monitoring SDK. Untuk aplikasi Android, Anda juga bisa memantau durasi metode tertentu menggunakan anotasi @AddTrace .
Kunjungi Tambahkan pemantauan untuk kode tertentu guna mempelajari lebih lanjut tentang fitur ini dan cara menambahkannya ke aplikasi Anda.
Langkah 6 : Terapkan aplikasi Anda lalu tinjau hasilnya
Setelah Anda memvalidasi Performance Monitoring menggunakan satu atau beberapa perangkat pengujian, Anda dapat menerapkan versi terbaru aplikasi Anda kepada pengguna.
Anda dapat memantau data performa di dasbor Performa Firebase console.
Masalah Dikenal
Plugin Performance Monitoring Gradle v1.1.0 dapat menyebabkan ketidakcocokan dalam dependensi Guava, yang mengakibatkan error berikut:
Error:Execution failed for task ':app:packageInstantRunResourcesDebug'. > com.google.common.util.concurrent.MoreExecutors.directExecutor()Ljava/util/concurrent/Executor;
Jika Anda melihat kesalahan ini, Anda dapat:
Tingkatkan plugin Performance Monitoring ke v1.1.1 atau lebih baru (yang terbaru adalah v1.4.2).
Ganti baris dependensi plugin Performance Monitoring di file Gradle level root (level proyek) Anda (
build.gradle
), sebagai berikut:buildscript { // ... dependencies { // ... // Replace the standard Performance Monitoring plugin dependency line, as follows: classpath ('com.google.firebase:perf-plugin:1.1.0') { exclude group: 'com.google.guava', module: 'guava-jdk5' } } }
Performance Monitoring melaporkan ukuran payload total untuk permintaan jaringan HTTP berdasarkan nilai yang ditetapkan di header panjang konten HTTP. Nilai ini mungkin tidak selalu akurat.
Pemantauan Kinerja hanya mendukung proses utama dalam aplikasi Android multi-proses.
Langkah selanjutnya
Tinjau dan jalankan contoh kode Android Performance Monitoring di GitHub .
Pelajari lebih lanjut tentang data yang dikumpulkan secara otomatis oleh Performance Monitoring:
- Data yang terkait dengan siklus hidup aplikasi Anda, seperti waktu mulai aplikasi
- Data untuk perenderan layar di aplikasi Anda
- Data untuk permintaan jaringan HTTP/S yang dikeluarkan oleh aplikasi Anda
Lihat, lacak, dan filter data performa Anda di Firebase console.
Tambahkan pemantauan untuk tugas atau alur kerja tertentu di aplikasi Anda dengan memperlengkapi pelacakan kode khusus .