Pemecahan masalah dan FAQ Performance Monitoring

iOS+ Android Web

Halaman ini memberikan tips pemecahan masalah untuk memulai Performance Monitoring atau menggunakan berbagai fitur dan alat Performance Monitoring.

Pemeriksaan awal untuk pemecahan masalah

Kedua pemeriksaan berikut adalah praktik terbaik umum yang direkomendasikan untuk siapa pun sebelum memecahkan masalah lebih lanjut.

1. Memeriksa peristiwa performa pada pesan log

Periksa pesan log Anda untuk memastikan bahwa Performance Monitoring SDK menangkap peristiwa performa.

Cara melihat peristiwa performa pada pesan log

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

2. Memeriksa Dasbor Status Firebase

Periksa Dasbor Status Firebase untuk melihat apakah ada gangguan layanan yang diketahui untuk Firebase atau Performance Monitoring.

Mulai menggunakan Performance Monitoring

Jika Anda baru mulai menggunakan Performance Monitoring (iOS+ | Android | Web), tips pemecahan masalah berikut dapat membantu mengatasi masalah terkait pendeteksian SDK oleh Firebase atau penampilan data performa pertama Anda di Firebase console.

Sudah menambahkan SDK ke aplikasi, tetapi konsol masih tetap meminta menambahkan SDK

Firebase dapat mendeteksi apakah Anda berhasil menambahkan Performance Monitoring SDK ke aplikasi saat menerima informasi peristiwa (seperti interaksi aplikasi) dari aplikasi. Biasanya dalam waktu 10 menit setelah memulai aplikasi, dasbor Performance di Firebase console menampilkan pesan "SDK terdeteksi". Kemudian, dalam waktu 30 menit, dasbor akan menampilkan data awal yang diproses.

Jika sudah lebih dari 10 menit berlalu sejak versi SDK terbaru ditambahkan ke aplikasi dan Anda belum melihat perubahan apa pun, periksa pesan log untuk memastikan Performance Monitoring mencatat peristiwa ke dalam log. Coba langkah pemecahan masalah yang sesuai seperti yang dijelaskan di bawah untuk memecahkan masalah pesan deteksi SDK yang tertunda.

Aplikasi mencatat peristiwa ke dalam log: langkah pemecahan masalah

Catatan: Performance Monitoring SDK mengelompokkan peristiwa secara lokal, lalu mengirimkannya ke Firebase secara berkala. Jadi, terdapat penundaan antara waktu interaksi aplikasi dan waktu penerimaan informasi peristiwa dari aplikasi ke Firebase.

1. Pastikan Anda menggunakan Performance Monitoring Android SDK 19.1.0 atau yang lebih baru (atau Firebase BoM 26.3.0 atau yang lebih baru), lihat Catatan Rilis.

2. Jika Anda masih melakukan pengembangan secara lokal, cobalah membuat lebih banyak peristiwa untuk pengumpulan data:

   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.

3. Pastikan file konfigurasi Firebase (google-services.json) ditambahkan dengan benar ke aplikasi dan file tersebut belum diubah. Khususnya, pastikan hal berikut:

   • Nama file konfigurasi tidak ditambahi karakter lain, seperti (2).

   • File konfigurasi ada di direktori modul (level aplikasi) aplikasi.

   • ID Aplikasi Android Firebase (mobilesdk_app_id) yang tercantum dalam file konfigurasi sudah benar untuk aplikasi. Temukan ID Aplikasi Firebase di kartu Your apps pada Project settings.

   Jika merasa ada yang salah dengan file konfigurasi di aplikasi Anda, coba langkah berikut:

   1. Hapus file konfigurasi yang saat ini Anda miliki di aplikasi.

   2. Ikuti petunjuk ini untuk mendownload file konfigurasi baru dan menambahkannya ke aplikasi Android Anda.

4. Jika SDK mencatat peristiwa ke dalam log dan sepertinya semua telah disiapkan dengan benar, tetapi Anda masih belum melihat pesan deteksi SDK atau data yang diproses (setelah 10 menit), hubungi Dukungan Firebase.

Aplikasi tidak mencatat peristiwa ke dalam log: langkah pemecahan masalah

1. Periksa penyiapan plugin Gradle Performance Monitoring, sebagai berikut:

   1. Pastikan Anda sudah menambahkan plugin dengan benar. Khususnya, pastikan hal berikut:

      • Anda sudah menambahkan plugin (apply plugin: 'com.google.firebase.firebase-perf') di file build.gradle modul (level aplikasi).
      • Anda sudah menyertakan dependensi classpath untuk plugin (classpath 'com.google.firebase:perf-plugin:1.4.2') di file build.gradle level project.

   2. Pastikan plugin tidak dinonaktifkan melalui salah satu flag berikut:

      • instrumentationEnabled di file build.gradle modul (level aplikasi) Anda
      • firebasePerformanceInstrumentationEnabled di file gradle.properties

2. Pastikan Performance Monitoring SDK tidak dinonaktifkan melalui salah satu flag berikut di file AndroidManifest.xml Anda:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

3. Pastikan bahwa Performance Monitoring tidak dinonaktifkan di Google Cloud.

4. Jika Anda tidak dapat menemukan apa pun yang dinonaktifkan di aplikasi Anda, hubungi Dukungan Firebase.

Console mendeteksi SDK, tetapi tidak ada data yang ditampilkan

Performance Monitoring memproses data peristiwa performa sebelum menampilkannya di dasbor Performance.

Jika sudah lebih dari 24 jam berlalu sejak pesan "SDK detected" muncul dan data tetap belum terlihat, periksa Dasbor Status Firebase untuk melihat apakah terjadi gangguan layanan yang diketahui. Jika tidak ada gangguan layanan, hubungi Dukungan Firebase.

Pemecahan masalah umum

Jika Anda berhasil menambahkan SDK dan menggunakan Performance Monitoring di aplikasi, tips pemecahan masalah berikut dapat membantu mengatasi masalah umum yang melibatkan fitur dan serangkaian alat Performance Monitoring.

Aplikasi tidak mencatat peristiwa performa ke dalam log

Jika Anda tidak melihat pesan log untuk peristiwa performa, coba langkah pemecahan masalah berikut:

1. Periksa penyiapan plugin Gradle Performance Monitoring, sebagai berikut:

   1. Pastikan Anda sudah menambahkan plugin dengan benar. Khususnya, pastikan hal berikut:

      • Anda sudah menambahkan plugin (apply plugin: 'com.google.firebase.firebase-perf') di file build.gradle modul (level aplikasi).
      • Anda sudah menyertakan dependensi classpath untuk plugin (classpath 'com.google.firebase:perf-plugin:1.4.2') di file build.gradle level project.

   2. Pastikan plugin tidak dinonaktifkan melalui salah satu flag berikut:

      • instrumentationEnabled di file build.gradle modul (level aplikasi) Anda
      • firebasePerformanceInstrumentationEnabled di file gradle.properties

2. Pastikan Performance Monitoring SDK tidak dinonaktifkan melalui salah satu flag berikut di file AndroidManifest.xml Anda:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

3. Pastikan bahwa Performance Monitoring tidak dinonaktifkan di Google Cloud.

4. Jika Anda tidak dapat menemukan apa pun yang dinonaktifkan di aplikasi Anda, hubungi Dukungan Firebase.

Tidak ada data pelacakan layar pada dasbor performa

Jika data trace rendering layar tidak ada, coba langkah pemecahan masalah berikut:

1. Pastikan Anda menggunakan Android SDK versi terbaru (v21.0.2). Trace rendering layar hanya tersedia dengan v15.2.0 atau yang lebih baru.

2. Pastikan Anda belum menonaktifkan Akselerasi Hardware secara manual untuk layar.

3. Pastikan Anda tidak menggunakan DexGuard atau Jack. Performance Monitoring tidak kompatibel dengan toolchain ini.

   • DexGuard menonaktifkan pengumpulan otomatis trace saat aplikasi dimulai, aplikasi di latar depan, dan aplikasi di latar belakang. Namun, setiap trace kode kustom seharusnya berperilaku normal jika aplikasi Anda menggunakan DexGuard.

   • Jack tidak digunakan lagi dan umumnya tidak boleh digunakan di aplikasi Anda.

Tidak ada data trace kustom di dasbor Performance

Apakah Anda melihat data performa untuk trace yang dikumpulkan secara otomatis, tetapi tidak untuk trace kode kustom? Coba langkah-langkah pemecahan masalah berikut:

1. Jika Anda menginstrumentasikan trace kode kustom melalui Trace API, periksa penyiapan trace, terutama yang berikut:

   • Nama untuk trace kode kustom dan metrik kustom harus memenuhi persyaratan berikut: tidak boleh ada spasi kosong di awal atau akhir, tidak boleh diawali karakter garis bawah (_), dan panjang maksimal adalah 32 karakter.
   • Semua trace harus dimulai dan dihentikan. Setiap trace yang belum dimulai, tidak dihentikan, atau dihentikan sebelum dimulai tidak akan dicatat dalam log.

2. Jika Anda menginstrumentasikan trace kode kustom melalui notasi @AddTrace, periksa penyiapan plugin Gradle Performance Monitoring:

   1. Pastikan Anda sudah menambahkan plugin dengan benar. Khususnya, pastikan hal berikut:

      • Anda sudah menambahkan plugin (apply plugin: 'com.google.firebase.firebase-perf') di file build.gradle modul (level aplikasi).
      • Anda sudah menyertakan dependensi classpath untuk plugin (classpath 'com.google.firebase:perf-plugin:1.4.2') di file build.gradle level project.

   2. Pastikan plugin tidak dinonaktifkan melalui salah satu flag berikut:

      • instrumentationEnabled di file build.gradle modul (level aplikasi) Anda
      • firebasePerformanceInstrumentationEnabled di file gradle.properties

3. Periksa pesan log Anda untuk memastikan bahwa Performance Monitoring mencatat log trace kode kustom yang diharapkan.

4. Jika Performance Monitoring mencatat peristiwa ke dalam log, tetapi tidak ada data yang ditampilkan setelah 24 jam, hubungi Dukungan Firebase.

Tidak ada data permintaan jaringan pada dasbor Performance

Jika data permintaan jaringan tidak muncul, coba langkah pemecahan masalah berikut:

1. Untuk aplikasi Android, plugin Gradle Performance Monitoring mengaktifkan instrumentasi yang menyediakan pemantauan otomatis permintaan jaringan HTTP/S. Periksa hal-hal berikut:

   1. Pastikan Anda sudah menambahkan plugin dengan benar. Khususnya, pastikan hal berikut:

      • Anda sudah menambahkan plugin (apply plugin: 'com.google.firebase.firebase-perf') di file build.gradle modul (level aplikasi).
      • Anda sudah menyertakan dependensi classpath untuk plugin (classpath 'com.google.firebase:perf-plugin:1.4.2') di file build.gradle level project.

   2. Pastikan plugin tidak dinonaktifkan melalui salah satu flag berikut:

      • instrumentationEnabled di file build.gradle modul (level aplikasi) Anda
      • firebasePerformanceInstrumentationEnabled di file gradle.properties

2. Periksa jika ada inkompatibilitas library jaringan. Performance Monitoring otomatis mengumpulkan metrik untuk permintaan jaringan yang menggunakan library jaringan berikut: OkHttp 3.x.x, URLConnection dari Java, dan Apache HttpClient.

   Perlu diperhatikan bahwa Anda dapat menambahkan pemantauan kustom untuk permintaan jaringan.

3. Perhatikan hal-hal berikut:

   • Bergantung pada perilaku kode dan library jaringan yang digunakan oleh kode Anda, Performance Monitoring mungkin hanya melaporkan permintaan jaringan yang telah selesai. Ini berarti koneksi HTTP/S yang dibiarkan terbuka mungkin tidak dilaporkan.

   • Performance Monitoring tidak kompatibel dengan DexGuard dan Jack.

     • DexGuard menonaktifkan pemantauan permintaan jaringan HTTP/S.
     • Jack tidak digunakan lagi dan umumnya tidak boleh digunakan di aplikasi Anda.

   • Performance Monitoring tidak melaporkan permintaan jaringan dengan header Content-Type yang tidak valid. Namun, permintaan jaringan tanpa header Content-Type akan tetap diterima.

Data permintaan jaringan tidak diagregasikan seperti yang diharapkan

Pelajari lebih lanjut cara Performance Monitoring menggabungkan data permintaan jaringan berdasarkan pola URL.

Anda juga dapat mencoba pola URL kustom.

FAQ

iOS+ Android Web

Apa yang terjadi dengan Top Issues di kartu Performance di beranda Project?

Kami mengganti Top Issues dengan Recent Alerts sebagai tindak lanjut dari pemberitahuan kami yang baru-baru ini diperkenalkan, yang secara otomatis akan memberi tahu Anda jika batas yang telah ditetapkan sudah terlampaui. Issues (masalah) kini tidak digunakan lagi dan diganti dengan alerts (pemberitahuan).

Pemilih aplikasi di bagian atas kartu Performance memfilter entri pemberitahuan di bagian Recent Alerts. Hanya tiga pemberitahuan terbaru untuk aplikasi yang dipilih yang ditampilkan.

Untuk mempelajari pemberitahuan lebih lanjut, lihat Menyiapkan pemberitahuan untuk masalah performa.

Apa yang terjadi pada kemampuan menetapkan ambang batas untuk masalah di konsol?

Performance Monitoring mendukung pemberitahuan untuk metrik yang melebihi nilai minimum yang ditentukan. Untuk mencegah kebingungan mengenai nilai minimum yang dapat dikonfigurasi untuk metrik performa ini, kami menghapus kemampuan mengonfigurasi nilai minimum untuk masalah.

Apa yang terjadi pada informasi Details dan Metrics di Firebase console?

Kami mengganti halaman Details and Metrics dengan antarmuka pengguna (UI) terpusat baru yang didesain ulang untuk memudahkan Anda memecahkan masalah. UI pemecahan masalah yang baru ini menawarkan fungsi inti yang sama dengan yang ditawarkan halaman Details and Metrics. Untuk mempelajari pemecahan masalah lebih lanjut, baca Melihat data lainnya untuk trace tertentu.

Mengapa jumlah sampel tidak sesuai dengan yang saya harapkan?

Performance Monitoring mengumpulkan data performa dari perangkat pengguna aplikasi Anda. Jika aplikasi Anda memiliki banyak pengguna atau jika aplikasi menghasilkan banyak aktivitas performa, Performance Monitoring mungkin membatasi pengumpulan data hanya pada sebagian perangkat guna mengurangi jumlah peristiwa yang diproses. Batas ini cukup tinggi sehingga, meskipun dengan peristiwa yang lebih sedikit, nilai metrik masih mewakili pengalaman aplikasi pengguna Anda.

Untuk mengelola volume data yang kami kumpulkan, Performance Monitoring menggunakan opsi pengambilan sampel berikut:

• Pembatasan kapasitas di perangkat: Agar perangkat tidak mengirim burst trace secara tiba-tiba, kami membatasi jumlah trace permintaan jaringan dan kode yang dikirim dari perangkat ke 300 peristiwa setiap 10 menit. Pendekatan ini melindungi perangkat dari instrumentasi berulang yang dapat mengirim data performa dalam jumlah besar, dan mencegah satu perangkat mendistorsi pengukuran performa.

• Pengambilan sampel dinamis: Performance Monitoring mengumpulkan trace kode dan trace permintaan jaringan dalam jumlah terbatas per aplikasi setiap hari untuk semua pengguna aplikasi. Frekuensi sampling dinamis diambil di perangkat (menggunakan Firebase Remote Config) untuk menentukan apakah perangkat acak harus mengambil dan mengirim trace. Perangkat yang tidak dipilih untuk pengambilan sampel tidak akan mengirim peristiwa apa pun. Frekuensi sampling dinamis bersifat khusus aplikasi dan disesuaikan untuk memastikan volume keseluruhan data yang dikumpulkan tetap di bawah batas.

  Project yang mengaktifkan integrasi BigQuery menerima batas yang lebih tinggi untuk jumlah trace permintaan jaringan.

  Sesi pengguna mengirim detail data tambahan dari perangkat pengguna, yang memerlukan lebih banyak resource untuk mengambil dan mengirim data. Untuk meminimalkan dampak sesi pengguna, Performance Monitoring juga dapat membatasi jumlah sesi.

• Pembatasan kapasitas sisi server: Untuk memastikan aplikasi tidak melebihi batas pengambilan sampel, Performance Monitoring mungkin menggunakan pengambilan sampel sisi server untuk menghapus beberapa peristiwa yang diterima dari perangkat. Meskipun jenis pembatasan ini tidak mengubah keefektifan metrik kami, hal ini dapat menyebabkan perubahan pola yang kecil, termasuk berikut:

  • Jumlah trace dapat berbeda dengan frekuensi eksekusi kode.
  • Setiap trace yang dikaitkan secara erat dalam kode mungkin memiliki jumlah sampel yang berbeda.

Catatan: Batas pengambilan sampel tertentu dan penerapannya mungkin berubah seiring perkembangan Performance Monitoring.

Apa yang terjadi pada tab Issues di console?

Kami mengganti tab Issues dan memperkenalkan Alerts, yang otomatis memberi tahu Anda saat nilai minimum yang Anda tetapkan terlampaui. Anda tidak perlu lagi memeriksa Firebase console secara manual untuk menentukan status nilai minimum. Untuk mempelajari Alerts, lihat Menyiapkan notifikasi untuk masalah performa.

Apa yang terjadi pada tab On Device dan Network di console? Bagaimana cara melihat trace yang ada di halaman tersebut?

Kami telah mendesain ulang bagian Performance Monitoring pada Firebase console sehingga tab Dashboard menampilkan metrik utama dan semua trace Anda dalam satu ruang. Sebagai bagian dari desain ulang ini, kami menghapus halaman On Device dan Network.

Tabel trace di bagian bawah tab Dashboard memiliki semua informasi yang sama dengan yang ditampilkan tab On Device dan Network, tetapi dengan beberapa fitur tambahan, termasuk kemampuan untuk mengurutkan trace Anda berdasarkan perubahan persentase untuk metrik tertentu. Untuk melihat semua metrik dan data untuk trace tertentu, klik nama trace di tabel trace.

Lihat trace Anda dalam subtab tabel trace berikut:

• Trace permintaan jaringan (siap pakai dan kustom) — subtab Network requests
• Trace kode kustom — subtab Custom traces
• Trace aplikasi dimulai, aplikasi di latar depan, aplikasi di latar belakang — subtab Custom traces
• Trace rendering layar — subtab Screen rendering
• Trace pemuatan halaman — subtab Page load

Untuk melihat detail tentang tabel trace serta cara melihat metrik dan data, buka halaman ringkasan console (iOS+ | Android | Web).

Mengapa jumlah periode frozen dan lambat tidak seperti yang saya harapkan?

Periode rendering lambat dan periode frozen dihitung dengan asumsi kecepatan refresh perangkat sebesar 60 Hz. Jika kecepatan refresh perangkat lebih rendah dari 60 Hz, setiap periode akan memiliki waktu rendering yang lebih lambat karena lebih sedikit periode yang dirender per detik. Waktu rendering yang lebih lambat dapat menyebabkan lebih banyak periode lambat atau frozen yang dilaporkan karena lebih banyak periode yang akan dirender lebih lambat atau akan dibekukan. Namun, jika kecepatan refresh perangkat lebih tinggi dari 60 Hz, setiap periode akan memiliki waktu rendering yang lebih cepat. Ini dapat menyebabkan lebih sedikit periode frozen atau periode lambat yang dilaporkan. Ini adalah batasan saat ini dalam Performance Monitoring SDK.

Mengapa saya tidak dapat melihat trace fragmen?

Untuk melihat performa fragmen selain aktivitas aplikasi, pastikan aplikasi Anda menggunakan Performance Monitoring Android SDK versi 20.1.0 atau yang lebih tinggi. Untuk mempelajari lebih lanjut, lihat Menambahkan Performance Monitoring ke aplikasi Anda.

Bagaimana cara mengetahui trace mana yang terkait dengan fragmen dan aktivitas?

Setiap trace aktivitas dan fragmen didasarkan pada nama class-nya seperti yang ditetapkan dalam aplikasi Anda. Setiap trace layar berisi awalan st diikuti dengan nama class. Di Firebase console, awalan akan dihapus. Untuk mempelajari lebih lanjut, lihat Pelajari data performa rendering layar (aplikasi Apple & Android) .

Mengapa saya melihat trace fragmen yang lebih sedikit daripada trace yang lain?

Performance Monitoring melakukan pengambilan sampel peristiwa di semua peristiwa yang dikumpulkan di perangkat. Dengan pendekatan ini, kami dapat mengumpulkan peristiwa minimum yang diperlukan dari perangkat pengguna untuk memberikan metrik performa.

Bagaimana cara mendapatkan pemberitahuan saat ada masalah dengan performa rendering aplikasi saya?

Dengan Performance Monitoring, Anda dapat menyiapkan pemberitahuan untuk metrik yang penting bagi Anda. Untuk trace rendering layar yang dihasilkan, Anda dapat menyiapkan pemberitahuan untuk memberi tahu Anda saat persentase periode rendering frame lambat dan frozen melebihi nilai minimum yang Anda tetapkan.

Waktu build saya tinggi setelah mengaktifkan plugin Gradle Performance Monitoring. Bagaimana cara mengatasinya?

Performance Monitoring untuk Android menggunakan instrumentasi bytecode untuk memberikan beberapa fitur siap pakai seperti pemantauan permintaan jaringan HTTP/S. Sebagai bagian dari kompilasi, proses ini memerlukan iterasi melalui semua class aplikasi Anda (termasuk dependensi) untuk menginstrumentasikan kode yang penting dalam mengukur performa permintaan jaringan aplikasi Anda.

Berikut beberapa kontributor utama yang meningkatkan waktu build:

• Jumlah class atau file
• Ukuran setiap class tersebut (baris kode)
• Konfigurasi mesin Anda
• Build awal versus build berikutnya (build berikutnya biasanya lebih cepat daripada build awal)

Untuk mengoptimalkan waktu build, sebaiknya modularisasi kode Anda.

Mulai dengan versi v1.3.3 dari plugin Performance Monitoring, kami telah memusatkan perhatian untuk membuat peningkatan yang cukup besar dalam pemrosesan build secara inkremental dan caching untuk input library. Untuk menerima perbaikan waktu build terbaru, pastikan untuk menggunakan versi plugin terbaru (v1.4.2).

Perlu diperhatikan bahwa Anda dapat menonaktifkan plugin Performance Monitoring untuk build debug secara lokal jika ingin menghindari waktu build yang lama. Namun, pendekatan ini tidak direkomendasikan untuk build produksi, karena dapat menyebabkan tidak adanya pengukuran performa untuk permintaan jaringan di aplikasi Anda.

Apa yang harus saya lakukan jika mendapatkan error build karena library yang tidak kompatibel dengan plugin Gradle Performance Monitoring?

Performance Monitoring untuk Android menggunakan instrumentasi bytecode untuk memberikan beberapa fitur siap pakai seperti pemantauan permintaan jaringan HTTP/S. Sebagai bagian dari kompilasi, proses ini memerlukan iterasi melalui semua class aplikasi Anda (termasuk dependensi) untuk menginstrumentasikan kode yang penting dalam mengukur performa permintaan jaringan aplikasi Anda.

Jika Anda mendapatkan error build seperti JSR/RET are not supported with computeFrames option atau error serupa setelah berintegrasi dengan plugin Performance Monitoring, hal tersebut terjadi mungkin karena Anda juga memiliki dependensi pada library yang tidak kompatibel dengan plugin Gradle Performance Monitoring.

Untuk mengatasinya, Anda dapat mengecualikan class/library yang tidak kompatibel agar tidak diinstrumentasi dengan mengikuti langkah-langkah berikut:

1. Update plugin Gradle Performance Monitoring ke versi terbaru (minimum v1.4.0).
2. Update versi plugin Android Gradle Anda ke v7.2.0 atau yang lebih baru.
3. Tambahkan flag berikut ke file build.gradle modul (level aplikasi) Anda untuk mengecualikan class/library yang tidak kompatibel agar tidak diinstrumentasi:

   android {
     // ...
     androidComponents {
       onVariants(selector().all(), {
           instrumentation.excludes.add("example.incompatible.library")
       })
     }
   }

   Untuk mempelajari lebih lanjut properti exclude milik Instrumentation API plugin Android Gradle, lihat Instrumentasi.

Silakan ajukan masalah GitHub jika Anda menemukan error build akibat library yang tidak kompatibel sehingga library tersebut juga dapat dikecualikan dari proses instrumentasi dalam plugin Performance Monitoring.

Ekspor data Performance Monitoring saya ke BigQuery memakan waktu lebih lama dari yang diharapkan. Apakah proses tersebut tidak dilakukan secara real time?

Jika Anda telah mengaktifkan integrasi BigQuery untuk Firebase Performance Monitoring, data Anda akan diekspor ke BigQuery dalam waktu 12 hingga 24 jam setelah penghujung hari (Waktu Pasifik).

Misalnya, data untuk tanggal 19 April akan tersedia di BigQuery pada tanggal 20 April antara pukul 12.00 siang hingga tengah malam (semua tanggal dan jam berdasarkan Waktu Pasifik).

Tampilan dan pemrosesan data hampir real-time

Apa yang dimaksud dengan data performa "hampir real-time"?

Firebase Performance Monitoring memproses data performa yang dikumpulkan saat data tersebut masuk, sehingga menghasilkan tampilan data yang hampir real-time di Firebase console. Data yang diproses akan ditampilkan di console dalam beberapa menit setelah dikumpulkan, sehingga disebut "hampir real-time".

Untuk memanfaatkan pemrosesan data hampir real-time, pastikan aplikasi Anda menggunakan versi SDK yang kompatibel secara real-time.

Bagaimana cara mendapatkan data performa hampir real-time untuk aplikasi saya?

Untuk memanfaatkan pemrosesan data hampir real-time, Anda hanya perlu memastikan bahwa aplikasi Anda menggunakan versi Performance Monitoring SDK yang kompatibel dengan pemrosesan data real-time.

Berikut ini versi SDK yang kompatibel secara real-time:

• iOS — v7.3.0 atau yang lebih baru
• tvOS — v8.9.0 atau yang lebih baru
• Android — v19.0.10 atau yang lebih baru (atau Firebase Android BoM v26.1.0 atau yang lebih baru)
• Web — v7.14.0 atau yang lebih baru

Perhatikan bahwa kami selalu merekomendasikan penggunaan SDK versi terbaru, tetapi semua versi yang tercantum di atas akan memungkinkan Performance Monitoring memproses data Anda secara hampir real-time.

Versi Performance Monitoring SDK mana yang dianggap kompatibel secara real-time?

Berikut ini versi SDK yang kompatibel dengan pemrosesan data real-time:

• iOS — v7.3.0 atau yang lebih baru
• tvOS — v8.9.0 atau yang lebih baru
• Android — v19.0.10 atau yang lebih baru (atau Firebase Android BoM v26.1.0 atau yang lebih baru)
• Web — v7.14.0 atau yang lebih baru

Perhatikan bahwa kami selalu merekomendasikan penggunaan SDK versi terbaru, tetapi semua versi yang tercantum di atas akan memungkinkan Performance Monitoring memproses data Anda secara hampir real-time.

Apa konsekuensinya jika saya tidak mengupdate aplikasi untuk menggunakan versi SDK yang kompatibel secara real-time?

Jika aplikasi Anda tidak menggunakan versi SDK yang kompatibel secara real-time, Anda akan tetap dapat melihat semua data performa aplikasi di Firebase console. Namun, tampilan data performa akan tertunda sekitar 36 jam dari waktu pengumpulannya.

Saya telah mengupdate ke versi SDK yang kompatibel secara real-time, tetapi beberapa pengguna masih menggunakan versi lama dari aplikasi saya. Apakah saya akan terus melihat data performa mereka di Firebase console?

Ya. Terlepas dari versi SDK yang digunakan instance aplikasi, Anda akan melihat data performa dari semua pengguna.

Namun, jika Anda melihat data terbaru (kurang dari 36 jam terakhir), data yang ditampilkan akan berasal dari pengguna instance aplikasi yang menggunakan versi SDK yang kompatibel secara real-time. Namun, data yang bukan terbaru akan mencakup data performa dari semua versi aplikasi Anda.

Menghubungi Dukungan Firebase

Ketika menghubungi Dukungan Firebase, selalu sertakan ID Aplikasi Firebase Anda. Temukan ID Aplikasi Firebase di kartu Your apps pada Project settings.