Memulai Performance Monitoring untuk Android

Sebelum memulai

Tambahkan Firebase ke project Android jika Anda belum melakukannya.

Dalam build.gradle file level project, pastikan Anda memasukkan repositori Maven Google di bagian buildscript dan allprojects.

Langkah 1: Menambahkan Performance Monitoring SDK ke aplikasi Anda

Performance Monitoring SDK memungkinkan pemantauan pelacakan durasi otomatis dan pelacakan khusus tambahan di aplikasi Anda.

  1. Di file Gradle modul (level aplikasi) (biasanya app/build.gradle):

    // ...
    
    dependencies {
      // ...
    
      // Add the dependency for the Performance Monitoring library
      implementation 'com.google.firebase:firebase-perf:19.0.7'
    }
    
  2. Kompilasi ulang aplikasi Anda.

Langkah 2 : Menambahkan plugin Performance Monitoring ke aplikasi Anda

Plugin Performance Monitoring Gradle memungkinkan instrumentasi yang menyediakan pemrosesan anotasi @AddTrace dan pemantauan permintaan jaringan HTTP/S otomatis.

Untuk menambahkan plugin Performance Monitoring ke aplikasi Anda:

  1. Di file Gradle modul (level aplikasi) (biasanya app/build.gradle), terapkan plugin Performance Monitoring:

    apply plugin: 'com.android.application'
    apply plugin: 'com.google.gms.google-services'
    // Apply the Performance Monitoring plugin
    apply plugin: 'com.google.firebase.firebase-perf'
    
    android {
      // ...
    }
    
  2. Di file Gradle level root (level project) (build.gradle), tambahkan aturan untuk menyertakan plugin Performance Monitoring.

    buildscript {
    
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // Add the Bintray repository
          jcenter()
        }
    
        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:3.4.0'
    
          classpath 'com.google.gms:google-services:4.3.3'  // Google Services plugin
    
          // Add the dependency for the Performance Monitoring plugin
          classpath 'com.google.firebase:perf-plugin:1.3.1'  // Performance Monitoring plugin
        }
    }
    
  3. Kompilasi ulang aplikasi Anda.

Langkah 3: Membuat peristiwa performa untuk tampilan data awal

Firebase dapat mendeteksi bahwa Anda berhasil menambahkan SDK ke aplikasi saat menerima informasi peristiwa (seperti interaksi aplikasi) dari aplikasi. Jika Anda masih melakukan pengembangan secara lokal, lakukan interaksi dengan aplikasi untuk menghasilkan peristiwa untuk deteksi SDK serta pengumpulan dan pemrosesan data awal.

  1. Lanjutkan mengembangkan aplikasi Anda menggunakan emulator atau perangkat uji yang memenuhi persyaratan berikut:

    • Emulator Android dengan image terbaru dan layanan Google Play 15.0.0 atau versi yang lebih baru

    • Perangkat uji dengan layanan Google Play 15.0.0 atau versi yang lebih baru

  2. Hasilkan peristiwa dengan mengalihkan aplikasi di antara latar belakang dan latar depan beberapa kali, berinteraksi dengan aplikasi Anda dengan membuka seluruh layar, dan/atau memicu permintaan jaringan.

  3. Buka bagian Performa di Firebase console untuk melihat apakah Firebase telah mendeteksi SDK.

    Jika Anda tidak melihat pesan "SDK terdeteksi" dalam 2 jam setelah menambahkan SDK ke aplikasi, lihat tips pemecahan masalah.

  4. Performance Monitoring memproses data peristiwa performa sebelum menampilkannya di dasbor Performa. Anda akan melihat tampilan data awal dalam waktu 24 jam setelah melihat pesan deteksi SDK.

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

Langkah 4: (Opsional) Melihat pesan log untuk 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 lognya dengan FirebasePerformance. Dengan menggunakan pemfilteran logcat, Anda dapat secara khusus melihat pelacakan durasi dan logging permintaan jaringan HTTP/S dengan menjalankan perintah berikut:

    adb logcat -s FirebasePerformance
  4. Periksa jenis log berikut yang menunjukkan bahwa Performance Monitoring mencatat peristiwa performa:

    • Logging TraceMetric
    • Logging NetworkRequestMetric

Jika aplikasi Anda tidak mencatat peristiwa performa, lihat tips pemecahan masalah.

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

Anda dapat membuat pelacakan kustom untuk memantau data performa yang terkait dengan kode tertentu dalam aplikasi Anda.

Dengan pelacakan kustom, Anda dapat mengukur waktu yang diperlukan aplikasi untuk menyelesaikan tugas atau serangkaian tugas tertentu, misalnya memuat sekumpulan gambar atau membuat kueri database. Metrik default untuk pelacakan kustom adalah durasinya, tetapi Anda juga dapat menambahkan metrik kustom, seperti cache ditemukan dan peringatan memori.

Dalam kode, Anda menentukan awal dan akhir pelacakan 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.

Kunjungi Menambahkan pemantauan kustom untuk kode aplikasi tertentu untuk mempelajari lebih lanjut tentang fitur ini dan cara menambahkannya ke aplikasi Anda.

Langkah 6: Men-deploy aplikasi Anda lalu tinjau hasilnya

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

Anda dapat memantau data performa di dasbor Performa dari Firebase console.

Masalah umum

  • Plugin Performance Monitoring Gradle versi 1.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.3.1).

    • Mengganti baris dependensi plugin Performance Monitoring di file Gradle (build.gradle) level root (level project), 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 jumlah ukuran payload terhadap permintaan jaringan HTTP/S berdasarkan nilai yang ditetapkan pada header HTTP content-length. Nilai ini mungkin tidak selalu akurat.

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

Langkah berikutnya