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 mencatat peristiwa performa.
Cara melihat peristiwa performa pada pesan log
Aktifkan logging debug untuk Performance Monitoring pada waktu build dengan menambahkan elemen
<meta-data>
ke fileAndroidManifest.xml
aplikasi Anda, seperti berikut:<application> <meta-data android:name="firebase_performance_logcat_enabled" android:value="true" /> </application>
Periksa apakah ada pesan error di pesan log Anda.
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
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
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 untuk 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 Performa 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
Pastikan Anda menggunakan Performance Monitoring Android SDK 19.1.0 atau yang lebih baru (atau Firebase BoM 26.3.0 atau yang lebih baru), baca Catatan Rilis.
Jika Anda masih melakukan pengembangan secara lokal, cobalah membuat lebih banyak peristiwa untuk pengumpulan data:
- 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.
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 settings Project settings.
Jika merasa ada yang salah dengan file konfigurasi di aplikasi Anda, coba langkah berikut:
Hapus file konfigurasi yang saat ini Anda miliki di aplikasi.
Ikuti petunjuk ini untuk mendownload file konfigurasi baru dan menambahkannya ke aplikasi Android Anda.
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
Periksa penyiapan plugin Gradle Performance Monitoring, sebagai berikut:
Pastikan Anda sudah menambahkan plugin dengan benar. Khususnya, pastikan hal berikut:
- Anda sudah menambahkan plugin (
) di fileapply plugin: 'com.google.firebase.firebase-perf' build.gradle
modul (level aplikasi). - Anda sudah menyertakan dependensi classpath untuk plugin (
) di fileclasspath 'com.google.firebase:perf-plugin:1.4.2' build.gradle
level project.
- Anda sudah menambahkan plugin (
Pastikan plugin tidak dinonaktifkan melalui salah satu flag berikut:
instrumentationEnabled
di filebuild.gradle
modul (level aplikasi) AndafirebasePerformanceInstrumentationEnabled
di filegradle.properties
Pastikan Performance Monitoring SDK tidak dinonaktifkan melalui salah satu flag berikut di file
AndroidManifest.xml
Anda:firebase_performance_collection_enabled
firebase_performance_collection_deactivated
Pastikan Performance Monitoring tidak dinonaktifkan pada runtime.
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:
Periksa penyiapan plugin Gradle Performance Monitoring, sebagai berikut:
Pastikan Anda sudah menambahkan plugin dengan benar. Khususnya, pastikan hal berikut:
- Anda sudah menambahkan plugin (
) di fileapply plugin: 'com.google.firebase.firebase-perf' build.gradle
modul (level aplikasi). - Anda sudah menyertakan dependensi classpath untuk plugin (
) di fileclasspath 'com.google.firebase:perf-plugin:1.4.2' build.gradle
level project.
- Anda sudah menambahkan plugin (
Pastikan plugin tidak dinonaktifkan melalui salah satu flag berikut:
instrumentationEnabled
di filebuild.gradle
modul (level aplikasi) AndafirebasePerformanceInstrumentationEnabled
di filegradle.properties
Pastikan Performance Monitoring SDK tidak dinonaktifkan melalui salah satu flag berikut di file
AndroidManifest.xml
Anda:firebase_performance_collection_enabled
firebase_performance_collection_deactivated
Pastikan Performance Monitoring tidak dinonaktifkan pada runtime.
Jika Anda tidak dapat menemukan apa pun yang dinonaktifkan di aplikasi Anda, hubungi Dukungan Firebase.
Tidak ada data trace layar di dasbor Performance
Jika data trace rendering layar tidak ada, coba langkah pemecahan masalah berikut:
Pastikan Anda menggunakan Android SDK versi terbaru (v21.0.1). Trace rendering layar hanya tersedia dengan v15.2.0 atau yang lebih baru.
Pastikan Anda belum menonaktifkan Akselerasi Hardware secara manual untuk layar.
Pastikan Anda tidak menggunakan DexGuard atau Jack. Performance Monitoring tidak kompatibel dengan toolchain tersebut.
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:
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.
- 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 (
Jika Anda menginstrumentasikan trace kode kustom melalui notasi
@AddTrace
, periksa penyiapan plugin Gradle Performance Monitoring:Pastikan Anda sudah menambahkan plugin dengan benar. Khususnya, pastikan hal berikut:
- Anda sudah menambahkan plugin (
) di fileapply plugin: 'com.google.firebase.firebase-perf' build.gradle
modul (level aplikasi). - Anda sudah menyertakan dependensi classpath untuk plugin (
) di fileclasspath 'com.google.firebase:perf-plugin:1.4.2' build.gradle
level project.
- Anda sudah menambahkan plugin (
Pastikan plugin tidak dinonaktifkan melalui salah satu flag berikut:
instrumentationEnabled
di filebuild.gradle
modul (level aplikasi) AndafirebasePerformanceInstrumentationEnabled
di filegradle.properties
Periksa pesan log Anda untuk memastikan bahwa Performance Monitoring mencatat log trace kode kustom yang diharapkan.
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:
Untuk aplikasi Android, plugin Gradle Performance Monitoring mengaktifkan instrumentasi yang memberikan pemantauan otomatis permintaan jaringan HTTP/S. Periksa hal-hal berikut:
Pastikan Anda sudah menambahkan plugin dengan benar. Khususnya, pastikan hal berikut:
- Anda sudah menambahkan plugin (
) di fileapply plugin: 'com.google.firebase.firebase-perf' build.gradle
modul (level aplikasi). - Anda sudah menyertakan dependensi classpath untuk plugin (
) di fileclasspath 'com.google.firebase:perf-plugin:1.4.2' build.gradle
level project.
- Anda sudah menambahkan plugin (
Pastikan plugin tidak dinonaktifkan melalui salah satu flag berikut:
instrumentationEnabled
di filebuild.gradle
modul (level aplikasi) AndafirebasePerformanceInstrumentationEnabled
di filegradle.properties
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.
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 headerContent-Type
akan tetap diterima.
Data permintaan jaringan tidak diagregasikan seperti yang diharapkan
Pelajari cara Performance Monitoring mengagregasikan data permintaan jaringan berdasarkan pola URL lebih lanjut.
Anda juga dapat mencoba pola URL kustom.
FAQ
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 nilai minimum 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 batas sekitar 100 juta peristiwa untuk trace kode dan 100 juta untuk trace permintaan jaringan 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.
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.
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 terbaru di 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 pada 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 dari plugin Performance Monitoring v1.3.3, 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:
- Update plugin Gradle Performance Monitoring ke versi terbaru (minimum v1.4.0).
- Update versi plugin Android Gradle Anda ke v7.2.0 atau yang lebih baru.
- Tambahkan flag berikut ke file
build.gradle
modul (level aplikasi) 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 propertiexclude
dariInstrumentation
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 settings Project settings.