Mulai Menggunakan Performance Monitoring untuk Android

Sebelum memulai

Tambahkan Firebase ke project Android jika Anda belum melakukannya.

Langkah 1: Tambahkan Performance Monitoring SDK ke aplikasi Anda

Setelah Anda menambahkan Performance Monitoring SDK, Firebase otomatis akan mulai mengumpulkan data untuk rendering layar aplikasi dan data yang terkait dengan siklus proses aplikasi (seperti waktu mulai aplikasi). Agar Firebase dapat memantau permintaan jaringan, Anda juga harus menambahkan plugin Gradle Performance Monitoring (langkah berikutnya).

1. Dalam file Gradle modul (level aplikasi), (biasanya <project>/<app-module>/build.gradle.kts atau <project>/<app-module>/build.gradle), tambahkan dependensi untuk library Performance Monitoring untuk Android. Sebaiknya gunakan Firebase Android BoM untuk mengontrol pembuatan versi library.

   dependencies {
       // Import the BoM for the Firebase platform
       implementation(platform("com.google.firebase:firebase-bom:33.1.2"))
   
       // 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 library Android Firebase yang kompatibel.

   (Alternatif) Tambahkan dependensi library Firebase tanpa menggunakan BoM

   Jika memilih untuk tidak menggunakan Firebase BoM, Anda harus menentukan setiap versi library Firebase di baris dependensinya.

   Perlu diperhatikan bahwa jika Anda menggunakan beberapa library Firebase di aplikasi, sebaiknya gunakan BoM untuk mengelola versi library, 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:21.0.1")
   }
   

   Mencari modul library khusus Kotlin? Mulai Oktober 2023 (Firebase BoM 32.5.0), developer Kotlin dan Java dapat bergantung pada modul library utama (untuk mengetahui detailnya, lihat FAQ tentang inisiatif ini).

2. Kompilasi ulang aplikasi Anda.

Catatan: Saat Anda menambahkan Performance Monitoring SDK ke aplikasi, Remote Config SDK akan disertakan sebagai dependensi. Jika sudah menggunakan Remote Config, Anda tidak akan melihat perbedaan apa pun. Namun, jika Anda baru menggunakan Remote Config, baca dokumentasi Remote Config untuk mempelajari lebih lanjut berbagai fitur yang dapat diakses di aplikasi.

Langkah 2: Tambahkan plugin Gradle Performance Monitoring ke aplikasi Anda

Setelah Anda menambahkan plugin Gradle Performance Monitoring, Firebase otomatis akan mulai mengumpulkan data untuk permintaan jaringan HTTP/S. Dengan plugin tersebut, Anda juga dapat menginstrumentasikan trace kode kustom menggunakan anotasi @AddTrace.

Cara kerja plugin Performance Monitoring

Sebelum kode Anda dikonversi menjadi file DEX, plugin Performance Monitoring akan menggunakan Transform API dan framework instrumentasi bytecode ASM untuk membuka file class aplikasi Anda yang telah dikompilasi dan menginstrumentasikan kode tersebut (untuk mengukur performa). Waktu yang diperlukan untuk menginstrumentasikan kode Anda sangat bergantung pada jumlah dan ukuran class Anda.

Jika aplikasi Anda membutuhkan waktu terlalu lama untuk mengompilasi, cobalah opsi berikut:

• Nonaktifkan plugin Performance Monitoring untuk build debug Anda pada waktu kompilasi
• Modularisasi kode Anda untuk mengoptimalkan kecepatan build

1. Di file Gradle level root (level project) (<project>/build.gradle.kts atau <project>/build.gradle), tambahkan plugin Gradle Performance Monitoring:

   Kotlin

   Apakah Anda masih menggunakan sintaksis buildscript? Pelajari cara menambahkan plugin Firebase menggunakan sintaksis tersebut.

   plugins {
       // To benefit from the latest Performance Monitoring plugin features,
       // update your Android Gradle plugin dependency to at least v3.4.0
       id("com.android.application") version "7.3.0" apply false
   
       // Make sure that you have the Google services Gradle plugin dependency
       id("com.google.gms.google-services") version "4.4.2" apply false
   
       // Add the dependency for the Performance Monitoring Gradle plugin
       id("com.google.firebase.firebase-perf") version "1.4.2" apply false
   }
   

   Groovy

   Apakah Anda masih menggunakan sintaksis buildscript? Pelajari cara menambahkan plugin Firebase menggunakan sintaksis tersebut.

   plugins {
       // To benefit from the latest Performance Monitoring plugin features,
       // update your Android Gradle plugin dependency to at least v3.4.0
       id 'com.android.application' version '7.3.0' apply false
   
       // Make sure that you have the Google services Gradle plugin dependency
       id 'com.google.gms.google-services' version '4.4.2' apply false
   
       // Add the dependency for the Performance Monitoring Gradle plugin
       id 'com.google.firebase.firebase-perf' version '1.4.2' apply false
   }
   

2. Dalam file Gradle module (level aplikasi) (biasanya <project>/<app-module>/build.gradle.kts atau <project>/<app-module>/build.gradle), tambahkan plugin Gradle Performance Monitoring:

   Kotlin

   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")
       ...
   }
   

   Groovy

   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'
       ...
   }
   

3. Kompilasi ulang aplikasi Anda.

Langkah 3: Buat peristiwa performa untuk tampilan data awal

Firebase mulai memproses peristiwa saat Anda berhasil menambahkan SDK ke aplikasi. Jika Anda masih melakukan pengembangan secara lokal, lakukan interaksi dengan aplikasi guna menghasilkan peristiwa untuk pengumpulan dan pemrosesan data awal.

Catatan: Performance Monitoring SDK mengelompokkan peristiwa ke dalam batch secara lokal, lalu mengirimkannya ke Firebase secara berkala (setiap 30 detik). Jadi, terdapat penundaan antara waktu interaksi aplikasi dan waktu penerimaan informasi peristiwa dari aplikasi ke Firebase.

1. Hasilkan peristiwa dengan mengalihkan aplikasi dari latar belakang ke latar depan dan sebaliknya beberapa kali, berinteraksi dengan aplikasi Anda dengan berpindah-pindah dari layar ke layar, dan/atau memicu permintaan jaringan.

2. Buka dasbor Performance di Firebase console. Anda akan melihat tampilan data awal dalam beberapa menit.

   Jika Anda tidak melihat tampilan data awal, lihat tips pemecahan masalah.

Langkah 4: (Opsional) Lihat pesan log untuk mencari peristiwa performa

1. Aktifkan logging debug untuk Performance Monitoring pada waktu build dengan menambahkan elemen <meta-data> ke file AndroidManifest.xml aplikasi Anda, seperti berikut:

   <application>
       <meta-data
         android:name="firebase_performance_logcat_enabled"
         android:value="true" />
   </application>
   

2. Periksa apakah ada pesan error di pesan log Anda.

3. Performance Monitoring menandai pesan log-nya dengan tag FirebasePerformance. Dengan menggunakan pemfilteran logcat, Anda dapat secara khusus melihat trace durasi dan logging permintaan jaringan HTTP/S dengan menjalankan perintah berikut:

   adb logcat -s FirebasePerformance

4. Cari jenis log berikut yang menunjukkan bahwa Performance Monitoring mencatat peristiwa performa ke dalam log:

   • Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
   • Logging network request trace: URL

5. Klik URL untuk melihat data Anda di Firebase console. Mungkin perlu waktu beberapa saat sampai data diperbarui di dasbor.

Jika aplikasi Anda tidak mencatat peristiwa performa ke dalam log, baca tips pemecahan masalah.

Langkah 5: (Opsional) Tambahkan pemantauan kustom untuk kode tertentu

Untuk memantau data performa yang terkait dengan kode tertentu di aplikasi, Anda dapat menginstrumentasikan trace kode kustom.

Dengan trace kode kustom, Anda dapat mengukur durasi yang dibutuhkan aplikasi untuk menyelesaikan satu atau serangkaian tugas tertentu, seperti memuat kumpulan gambar atau membuat kueri untuk database. Metrik default untuk trace kode kustom adalah durasinya, tetapi Anda juga dapat menambahkan metrik kustom, seperti cache ditemukan dan peringatan memori.

Dalam kode, Anda dapat menentukan awal dan akhir trace kode kustom (dan menambahkan metrik kustom yang diinginkan) menggunakan API yang disediakan oleh Performance Monitoring SDK. Untuk aplikasi Android, Anda juga dapat memantau durasi metode tertentu menggunakan anotasi @AddTrace.

Baca artikel Menambahkan pemantauan untuk kode tertentu untuk mempelajari lebih lanjut fitur ini dan cara menambahkannya ke aplikasi Anda.

Langkah 6: Deploy aplikasi Anda lalu tinjau hasilnya

Setelah memvalidasi Performance Monitoring menggunakan satu atau beberapa perangkat uji, Anda dapat men-deploy versi terbaru aplikasi Anda kepada pengguna.

Anda dapat memantau data performa di dasbor Performance di Firebase console.

Masalah umum

• Plugin Gradle Performance Monitoring v1.1.0 dapat menyebabkan ketidakcocokan pada dependensi Guava sehingga menghasilkan error berikut:

  Error:Execution failed for task ':app:packageInstantRunResourcesDebug'.
  > com.google.common.util.concurrent.MoreExecutors.directExecutor()Ljava/util/concurrent/Executor;

  Jika melihat pesan error ini, Anda dapat mencoba salah satu langkah berikut:

  • Mengupgrade plugin Performance Monitoring ke v1.1.1 atau versi yang lebih baru (versi terbaru adalah v1.4.2).

  • Mengganti baris dependensi plugin Performance Monitoring di file Gradle level-root (level project) (<project>/build.gradle.kts atau <project>/build.gradle), sebagai berikut:

    Kotlin

    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")
        }
      }
    }
    

    Groovy

    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 total ukuran payload untuk permintaan jaringan HTTP berdasarkan nilai yang ditetapkan pada header content-length HTTP. Nilai ini mungkin tidak selalu akurat.

• Performance Monitoring hanya mendukung proses utama dalam aplikasi Android multiproses.

Langkah berikutnya

• Tinjau dan jalankan contoh kode Performance Monitoring untuk Android di GitHub.

• Pelajari lebih lanjut data yang otomatis dikumpulkan oleh Performance Monitoring:

  • Data yang terkait dengan siklus proses aplikasi Anda, seperti waktu mulai aplikasi
  • Data untuk rendering 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 menginstrumentasikan trace kode kustom.

• Gunakan atribut untuk memfilter data performa.