Menambahkan pemantauan kustom untuk kode aplikasi tertentu

Anda dapat membuat pelacakan kustom untuk memantau data yang berkaitan dengan kode tertentu di aplikasi. Dengan pelacakan kustom, Anda dapat mengukur waktu yang diperlukan aplikasi untuk menyelesaikan suatu atau serangkaian tugas tertentu, contohnya memuat serangkaian gambar atau membuat kueri database. Metrik default untuk pelacakan kustom adalah durasinya, tetapi Anda juga dapat menambahkan metrik kustom.

Dalam kode, penentuan awal dan akhir pelacakan kustom dilakukan menggunakan API yang diberikan oleh Performance Monitoring SDK.

Pelacakan juga dapat dimulai setelah dibuat, dan aman untuk thread.

Perhatikan hal berikut:

  • Sebuah aplikasi dapat memiliki beberapa pelacakan kustom.
  • Beberapa trace kustom dapat berjalan secara bersamaan.
  • Nama untuk trace 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 100 karakter.

Atribut default, atribut khusus, dan metrik kustom

Untuk pelacakan kustom, Performance Monitoring otomatis membuat log untuk atribut default yang dikumpulkan untuk semua pelacakan (metadata yang berlaku, seperti versi aplikasi, negara, perangkat, browser, dll.) sehingga Anda dapat memfilter data di Firebase console. Untuk pelacakan kustom, Anda juga dapat menambahkan dan memantau atribut khusus (seperti level game atau properti pengguna).

Anda dapat mengonfigurasi pelacakan kustom lebih mendalam lagi guna mencatat metrik kustom untuk aktivitas yang berkaitan dengan performa yang terjadi dalam lingkup pelacakan. Misalnya, Anda dapat membuat metrik kustom untuk jumlah cache yang ditemukan dan terlewat, atau berapa kali UI tidak responsif selama periode waktu yang terasa. Data untuk metrik kustom ini ditampilkan di Firebase console bersama metrik default untuk trace. Setiap trace kustom dapat mencatat hingga 32 metrik, termasuk metrik durasi default dan metrik kustom tambahan.

Menambahkan pelacakan kustom dan metrik kustom

Menggunakan Trace API (Swift|Obj-C) untuk menambahkan pelacakan kustom dan metrik kustom untuk memantau kode aplikasi tertentu.

  1. Tambahkan modul Performance Monitoring ke header Anda:

    Swift

    import FirebasePerformance
    

    Objective-C

    @import FirebasePerformance;
    
  2. Untuk memulai dan menghentikan trace kustom, tutupi kode yang ingin Anda lacak dengan baris kode yang mirip dengan yang berikut ini:

    Swift

    let trace = Performance.startTrace(name: "customTraceName")
    
    // code that you want to trace
    
    trace.stop()
    

    Pelajari API untuk pelacakan kustom lebih lanjut.

    Objective-C

    FIRTrace *trace = [FIRPerformance startTraceWithName:@"customTraceName"];
    
    // code that you want to trace
    
    [trace stop];
    

    Pelajari API untuk pelacakan kustom lebih lanjut.

  3. Untuk menambahkan metrik kustom, tambahkan baris kode yang mirip dengan yang berikut ini setiap kali peristiwa tersebut terjadi. Misalnya, metrik kustom ini menghitung peristiwa terkait performa yang terjadi di aplikasi Anda, seperti cache ditemukan atau dicoba ulang.

    Swift

    let trace = Performance.startTrace(name: "customTraceName")
    
    trace.incrementMetric(named:"eventName", by: 1)
    // code that you want to trace (and log custom metrics)
    
    trace.stop()
    

    Objective-C

    FIRTrace *trace = [FIRPerformance startTraceWithName:@"customTraceName"];
    
    [trace incrementMetric:@"eventName" by:1];
    // code that you want to trace (and log custom metrics)
    
    [trace stop];
    

Memantau pelacakan dan metrik kustom di console

  1. Di Firebase console, buka dasbor Performa.

  2. Klik tab Di perangkat, lalu Anda dapat:

    • Melihat laporan cepat dari data yang dikumpulkan untuk semua pelacakan Anda.

    • Mengklik pelacakan tertentu untuk meninjau data pelacakan secara lebih mendetail.

    • Gunakan tombol Filter di sisi kiri atas dasbor untuk melakukan pemfilteran dasar data berdasarkan atributnya.

  3. Jika Anda mengklik pelacakan tertentu, console akan menampilkan ringkasan data yang terkumpul di kartu metrik, termasuk metrik Durasi default dan metrik kustom lain apa pun yang telah Anda konfigurasi untuk pelacakan kustom tersebut.

    • Gunakan opsi di kanan atas dasbor untuk melihat data durasi sebagai gabungan, sepanjang waktu, atau untuk setiap versi aplikasi Anda.

    • Gunakan tombol Filter di sisi kiri atas dasbor untuk melakukan pemfilteran dasar data berdasarkan atributnya.

  4. Untuk metrik apa pun, klik Lihat lainnya untuk meninjau informasi secara lebih mendalam tentang data yang dikumpulkan, serta untuk menggunakan fitur analisis yang lebih kaya. Misalnya, Anda dapat memfilter dan mengelompokkan data berdasarkan atribut dan melihat data dalam konteks sesi penggunaan aplikasi.

    Bagian berikut ini menjelaskan fitur yang tersedia dari laporan pelacakan mendalam.

Melihat detail sampel pelacakan selengkapnya

Anda dapat mendalami segmen permintaan jaringan atau pelacakan tertentu di Firebase console. Pengambilan sampel acak dari sesi yang terekam menunjukkan informasi berikut:

gambar halaman sesi Firebase Performance Monitoring

  • CPU: Jumlah waktu pengguna dan waktu sistem yang digunakan aplikasi Anda.

  • Memori: Jumlah memori heap yang digunakan aplikasi Anda. Memori heap adalah memori yang digunakan untuk alokasi dinamis, termasuk objek yang dibuat, objek yang dibatalkan alokasinya, dan objek yang aktif digunakan oleh aplikasi.

  • Informasi individual: Informasi terperinci tentang satu instance permintaan jaringan atau pelacakan, termasuk waktu mulai, waktu berakhir, durasi, ukuran permintaan, dan ukuran respons.

  • Instance serentak: Informasi tentang permintaan jaringan atau pelacakan yang terjadi pada saat yang bersamaan.

  • Atribut perangkat: Informasi tentang perangkat, termasuk versi aplikasi, model, versi OS, radio, dan atribut khusus.

Untuk melihat sampel terperinci tersebut di Firebase console, Anda dapat:

  • Membuka salah satu permintaan jaringan atau pelacakan aplikasi Anda, lalu klik Lihat sesi.

  • Mengklik link sesi atribut dari atribut tertentu.

gambar pelacakan Firebase Performance Monitoring dengan link ke sesi

Memfilter sesi berdasarkan persentil

Sesi yang dikumpulkan Performance Monitoring didistribusikan ke dalam persentil untuk setiap metrik. Sesi pada rentang persentil lebih rendah memiliki nilai lebih rendah untuk metrik tersebut daripada sesi pada rentang persentil lebih tinggi.

Untuk memfilter sesi yang tersedia berdasarkan persentil, gunakan menu drop-down persentil di atas detail sesi.

gambar halaman sesi Firebase Performance Monitoring

Langkah Berikutnya