Sebelum memulai
Jika belum dilakukan, tambahkan Firebase ke project iOS Anda.
Langkah 1: Menambahkan Performance Monitoring ke aplikasi Anda
Setelah Anda menambahkan Performance Monitoring SDK, Firebase akan otomatis mulai mengumpulkan data untuk rendering layar aplikasi, data yang terkait dengan siklus proses aplikasi (seperti waktu mulai aplikasi), dan data untuk permintaan jaringan HTTP/S.
Buka podfile yang Anda buat untuk project (atau jalankan
pod init
untuk membuatnya), lalu tambahkan baris berikut di dalam bagian target:pod 'Firebase/Performance'
Di direktori podfile, jalankan perintah berikut untuk menginstal Performance Monitoring SDK:
pod install
Buka file
.xcworkspace
menggunakan Xcode.- Impor modul Firebase di
UIApplicationDelegate
Anda:Swift
import Firebase
Objective-C
@import Firebase;
- Konfigurasikan instance bersama
FirebaseApp
, biasanya ada dalam metodeapplication:didFinishLaunchingWithOptions:
aplikasi Anda:Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
Kompilasi ulang aplikasi Anda.
Langkah 2: Membuat 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 untuk menghasilkan peristiwa untuk pengumpulan dan pemrosesan data awal.
Lanjutkan pengembangan aplikasi menggunakan simulator atau perangkat uji.
Hasilkan peristiwa dengan mengalihkan aplikasi dari latar belakang ke latar depan beberapa kali, berinteraksi dengan aplikasi Anda dengan berpindah-pindah dari layar ke layar, dan/atau memicu permintaan jaringan.
Buka dasbor Performa di Firebase console. Anda akan melihat tampilan data awal dalam beberapa menit.
Jika Anda tidak melihat tampilan data awal, lihat tips pemecahan masalah.
Langkah 3: (Opsional) Melihat pesan log untuk peristiwa performa
Aktifkan logging debug seperti berikut:
- Di Xcode (minimum v12.2), pilih Product > Scheme > Edit scheme.
- Pilih Run dari menu kiri, lalu pilih tab Arguments.
- Di bagian Arguments Passed on Launch, tambahkan
-FIRDebugEnabled
.
Periksa apakah ada pesan error di pesan log Anda.
Performance Monitoring menandai pesan lognya dengan
Firebase/Performance
sehingga Anda dapat memfilter pesan log.Periksa jenis log berikut yang menunjukkan bahwa Performance Monitoring mencatat peristiwa performa:
Logging trace metric: TRACE_NAME
Logging network request trace: URL
Jika aplikasi Anda tidak menerapkan logging peristiwa performa, baca tips pemecahan masalah.
Langkah 4: (Opsional) Menambahkan pemantauan kustom untuk kode tertentu
Untuk memantau data performa yang terkait dengan kode tertentu di aplikasi, Anda dapat memasukkan trace kode kustom.
Dengan trace kode kustom, Anda dapat mengukur berapa lama waktu yang dibutuhkan aplikasi untuk menyelesaikan tugas tertentu atau serangkaian tugas, seperti memuat kumpulan gambar atau membuat kueri 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 menentukan awal dan akhir trace kode kustom (dan menambahkan metrik kustom yang diinginkan) menggunakan API yang disediakan oleh Performance Monitoring SDK.
Baca artikel Menambahkan pemantauan untuk kode tertentu untuk mempelajari lebih lanjut fitur ini dan cara menambahkannya ke aplikasi Anda.
Langkah 5: Men-deploy aplikasi Anda, lalu meninjau hasilnya
Setelah memvalidasi Performance Monitoring menggunakan simulator Xcode dan satu atau beberapa perangkat uji, Anda dapat men-deploy versi terbaru aplikasi kepada pengguna.
Anda dapat memantau data performa di dasbor Performa dari Firebase console.
Masalah umum
- Performance Monitoring memiliki masalah kompatibilitas umum dengan GTMSQLite. Sebaiknya jangan gunakan Performance Monitoring dengan aplikasi yang menggunakan GTMSQLite.
- Method swizzling setelah memanggil
FirebaseApp.configure()
dapat mengganggu Performance Monitoring SDK. - Masalah umum dengan iOS 8.0-8.2 Simulator membuat Performance Monitoring tidak dapat merekam peristiwa performa. Masalah ini telah diperbaiki pada iOS 8.3 Simulator dan versi yang lebih baru.
- Koneksi yang dibuat menggunakan
backgroundSessionConfiguration
NSURLSession akan menampilkan waktu koneksi yang lebih lama dari yang diperkirakan. Koneksi ini dijalankan di luar proses dan pengaturan waktunya mencerminkan peristiwa callback dalam proses.
Langkah berikutnya
Tinjau dan jalankan contoh kode Performance Monitoring iOS 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.