Memulai Performance Monitoring untuk iOS

Sebelum memulai

Jika belum dilakukan, tambahkan Firebase ke project iOS Anda.

Langkah 1: Menambahkan Performance Monitoring ke aplikasi Anda

  1. Buka podfile yang Anda buat untuk project (atau jalankan pod init untuk membuatnya), lalu tambahkan baris berikut di dalam bagian target:

    pod 'Firebase/Performance'
  2. Di direktori podfile, jalankan perintah berikut untuk menginstal Performance Monitoring SDK:

    pod install
  3. Buka file .xcworkspace menggunakan Xcode.

  4. Impor modul Firebase di UIApplicationDelegate Anda:

    Swift

    import Firebase

    Objective-C

    @import Firebase;
  5. Konfigurasikan instance bersama FirebaseApp, yang biasanya ada dalam metode application:didFinishLaunchingWithOptions: aplikasi Anda:

    Swift

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  6. Kompilasi ulang aplikasi Anda.

Firebase kini memantau pelacakan durasi otomatis dan permintaan jaringan HTTP/S otomatis.

Langkah 2: 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 pengembangan aplikasi menggunakan simulator atau perangkat uji.

  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", 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 3: (Opsional) Melihat pesan log untuk peristiwa performa

  1. Aktifkan logging debug seperti berikut:

    1. Di Xcode (minimum v10.3), pilih Product > Scheme > Edit scheme.
    2. Pilih Run dari menu sebelah kiri, lalu pilih tab Arguments.
    3. Di bagian Arguments Passed on Launch, tambahkan -FIRDebugEnabled.
  2. Periksa apakah ada pesan error di pesan log Anda.

  3. Performance Monitoring menandai pesan lognya dengan Firebase/Performance sehingga Anda dapat memfilter pesan log.

  4. 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 mencatat peristiwa performa, lihat tips pemecahan masalah.

Langkah 4: (Opsional) Menambahkan pemantauan kustom untuk kode tertentu

Anda dapat membuat pelacakan kustom untuk memantau data performa yang terkait dengan kode tertentu di 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.

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

Langkah 5: Men-deploy aplikasi Anda lalu tinjau 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 daripada yang diharapkan. Koneksi ini dijalankan di luar proses dan pengaturan waktunya mencerminkan peristiwa callback dalam proses.

Langkah berikutnya