Ikuti semua informasi yang diumumkan di Firebase Summit, dan pelajari bagaimana Firebase dapat membantu Anda mempercepat pengembangan aplikasi dan menjalankan aplikasi dengan percaya diri. Pelajari Lebih Lanjut

Tambahkan pemantauan khusus untuk kode aplikasi tertentu

Performance Monitoring mengumpulkan jejak untuk membantu Anda memantau kinerja aplikasi Anda. Pelacakan adalah laporan data kinerja yang diambil antara dua titik waktu di aplikasi Anda.

Anda dapat membuat pelacakan sendiri untuk memantau data performa yang terkait dengan kode tertentu di aplikasi Anda. Dengan pelacakan kode khusus , Anda dapat mengukur waktu yang diperlukan aplikasi untuk menyelesaikan tugas tertentu atau serangkaian tugas, misalnya memuat sekumpulan gambar atau membuat kueri database Anda.

Metrik default untuk pelacakan kode khusus adalah "durasi" (waktu antara titik awal dan akhir pelacakan), tetapi Anda juga dapat menambahkan metrik khusus .

Dalam kode Anda, Anda menentukan awal dan akhir pelacakan kode kustom menggunakan API yang disediakan oleh Performance Monitoring SDK.kode khusus dapat dimulai kapan saja setelah dibuat, dan aman untuk thread.

Karena metrik default yang dikumpulkan untuk trace ini adalah "durasi", mereka terkadang disebut "Durasi trace".

Anda dapat melihat data dari pelacakan ini di subtab Pelacakan khusus pada tabel pelacakan, yang ada di bagian bawah dasbor Performa (pelajari lebih lanjut tentang menggunakan konsol nanti di halaman ini).

Atribut default, atribut khusus, dan metrik khusus

Untuk pelacakan kode kustom, Performance Monitoring secara otomatis mencatat atribut default (metadata umum seperti versi aplikasi, negara, perangkat, dll.) sehingga Anda dapat memfilter data untuk pelacakan di konsol Firebase. Anda juga dapat menambahkan dan memantau atribut khusus (seperti, level game atau properti pengguna).

Anda dapat mengonfigurasi pelacakan kode khusus lebih lanjut untuk merekam metrik khusus untuk peristiwa terkait kinerja yang terjadi dalam cakupan pelacakan. Misalnya, Anda dapat membuat metrik khusus untuk jumlah cache ditemukan dan hilang atau berapa kali UI menjadi tidak responsif selama jangka waktu tertentu.

Atribut khusus dan metrik khusus ditampilkan di konsol Firebase bersama dengan atribut default dan metrik default untuk pelacakan.

Tambahkan pelacakan kode khusus

Gunakan Performance Monitoring Trace API ( Swift | Obj-C ) untuk menambahkan pelacakan kode khusus untuk memantau kode aplikasi tertentu.

Perhatikan hal berikut:

  • Sebuah aplikasi dapat memiliki beberapa trace kode khusus.
  • Lebih dari satu pelacakan kode khusus dapat berjalan pada waktu yang sama.
  • Nama untuk trace kode kustom harus memenuhi persyaratan berikut: tidak ada spasi kosong di depan atau di belakang, tidak ada karakter garis bawah ( _ ) di depan, dan panjang maksimal adalah 100 karakter.
  • Pelacakan kode khusus mendukung penambahan metrik khusus dan atribut khusus .

Untuk memulai dan menghentikan pelacakan kode kustom, gabungkan kode yang ingin Anda lacak dengan baris kode yang mirip berikut ini:

Cepat

Catatan: Produk Firebase ini tidak tersedia di target macOS, Mac Catalyst, watchOS.
// Add the Performance Monitoring module to your header
import FirebasePerformance

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

// code that you want to trace

trace.stop()

Objective-C

Catatan: Produk Firebase ini tidak tersedia di target macOS, Mac Catalyst, watchOS.
// Add the Performance Monitoring module to your header
@import FirebasePerformance;

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

// code that you want to trace

[trace stop];

Tambahkan metrik khusus ke pelacakan kode khusus

Gunakan Performance Monitoring Trace API ( Swift | Obj-C ) untuk menambahkan metrik khusus ke pelacakan kode khusus.

Perhatikan hal berikut:

  • Nama untuk metrik khusus harus memenuhi persyaratan berikut: tidak boleh ada spasi kosong di depan atau di belakang, tidak ada karakter garis bawah ( _ ) di depan, dan panjang maksimum adalah 100 karakter.
  • Setiap pelacakan kode khusus dapat merekam hingga 32 metrik (termasuk metrik Durasi default).

Untuk menambahkan metrik khusus, tambahkan baris kode yang serupa dengan yang berikut ini setiap kali peristiwa terjadi. Misalnya, metrik khusus ini menghitung kejadian terkait kinerja yang terjadi di aplikasi Anda, seperti penemuan cache atau percobaan ulang.

Cepat

Catatan: Produk Firebase ini tidak tersedia di target macOS, Mac Catalyst, watchOS.
let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.incrementMetric(named:"EVENT_NAME", by: 1)
// code that you want to trace (and log custom metrics)

trace.stop()

Objective-C

Catatan: Produk Firebase ini tidak tersedia di target macOS, Mac Catalyst, watchOS.
FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace incrementMetric:@"EVENT_NAME" byInt:1];
// code that you want to trace (and log custom metrics)

[trace stop];

Buat atribut khusus untuk pelacakan kode khusus

Gunakan Performance Monitoring Trace API ( Swift | Obj-C ) untuk menambahkan atribut khusus ke pelacakan kode khusus.

Untuk menggunakan atribut khusus, tambahkan kode ke aplikasi Anda yang menentukan atribut dan mengaitkannya dengan pelacakan kode khusus tertentu. Anda dapat menyetel atribut khusus kapan saja antara saat pelacakan dimulai dan saat pelacakan berhenti.

Perhatikan hal berikut:

  • Nama untuk atribut khusus harus memenuhi persyaratan berikut:

    • Tidak ada spasi kosong di depan atau di belakang, tidak ada karakter garis bawah ( _ ) di depan
    • Tidak ada ruang
    • Panjang maksimal adalah 32 karakter
    • Karakter yang diperbolehkan untuk nama adalah AZ , az , dan _ .
  • Setiap pelacakan kode khusus dapat merekam hingga 5 atribut khusus.

  • Harap pastikan bahwa atribut khusus tidak berisi informasi apa pun yang mengidentifikasi seseorang secara pribadi kepada Google.

    Pelajari lebih lanjut tentang panduan ini

Cepat

Catatan: Produk Firebase ini tidak tersedia di target macOS, Mac Catalyst, watchOS.
let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

// Delete scenario.
trace.removeAttribute("experiment")

// Read attributes.
let attributes:[String, String] = trace.attributes;

Objective-C

Catatan: Produk Firebase ini tidak tersedia di target macOS, Mac Catalyst, watchOS.
FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [trace attributes];

Lacak, lihat, dan filter data kinerja

Lacak metrik tertentu di dasbor Anda

Untuk mempelajari tren metrik utama Anda, tambahkan ke papan metrik di bagian atas dasbor Performa . Anda dapat dengan cepat mengidentifikasi regresi dengan melihat perubahan dari minggu ke minggu atau memverifikasi bahwa perubahan terbaru pada kode Anda meningkatkan kinerja.

gambar papan metrik di dasbor Firebase Performance Monitoring

Untuk menambahkan metrik ke papan metrik Anda, ikuti langkah-langkah berikut:

  1. Buka dasbor Performa di konsol Firebase.
  2. Klik kartu metrik kosong, lalu pilih metrik yang ada untuk ditambahkan ke papan Anda.
  3. Klik pada kartu metrik terisi untuk opsi lainnya, misalnya untuk mengganti atau menghapus metrik.

Papan metrik menampilkan data metrik yang dikumpulkan dari waktu ke waktu, baik dalam bentuk grafik maupun sebagai perubahan persentase numerik.

Pelajari lebih lanjut tentang menggunakan dasbor .

Lihat jejak dan datanya

Untuk melihat pelacakan Anda, buka dasbor Performa di konsol Firebase, gulir ke bawah ke tabel pelacakan, lalu klik subtab yang sesuai. Tabel menampilkan beberapa metrik teratas untuk setiap pelacakan, dan Anda bahkan dapat mengurutkan daftar berdasarkan perubahan persentase untuk metrik tertentu.

Performance Monitoring menyediakan halaman pemecahan masalah di Firebase console yang menyoroti perubahan metrik, sehingga memudahkan untuk mengatasi dan meminimalkan dampak masalah performa pada aplikasi dan pengguna Anda dengan cepat. Anda dapat menggunakan halaman pemecahan masalah saat mempelajari potensi masalah kinerja, misalnya, dalam skenario berikut:

  • Anda memilih metrik yang relevan di dasbor dan melihat delta besar.
  • Di tabel pelacakan, Anda mengurutkan untuk menampilkan delta terbesar di bagian atas, dan Anda melihat perubahan persentase yang signifikan.
  • Anda menerima lansiran email yang memberi tahu Anda tentang masalah kinerja.

Anda dapat mengakses halaman pemecahan masalah dengan cara berikut:

  • Di dasbor metrik, klik tombol Lihat detail metrik .
  • Di kartu metrik apa pun, pilih => Lihat detail . Halaman pemecahan masalah menampilkan informasi tentang metrik yang Anda pilih.
  • Di tabel pelacakan, klik nama pelacakan atau nilai metrik apa pun di baris yang terkait dengan pelacakan tersebut.
  • Di lansiran email, klik Selidiki sekarang .

Saat Anda mengklik nama pelacakan di tabel pelacakan, Anda kemudian dapat menyibak metrik yang diinginkan. Klik tombol filter untuk memfilter data berdasarkan atribut, misalnya:

gambar data Firebase Performance Monitoring yang difilter berdasarkan atribut
  • Filter berdasarkan versi Aplikasi untuk melihat data tentang rilis sebelumnya atau rilis terbaru Anda
  • Filter menurut Perangkat untuk mempelajari cara perangkat lama menangani aplikasi Anda
  • Filter menurut Negara untuk memastikan lokasi database Anda tidak memengaruhi wilayah tertentu

Pelajari lebih lanjut tentang melihat data untuk pelacakan Anda .

Langkah selanjutnya

  • Pelajari lebih lanjut cara menggunakan atribut untuk memeriksa data performa.

  • Pelajari lebih lanjut cara melacak masalah performa di Firebase console.

  • Siapkan peringatan untuk perubahan kode yang menurunkan kinerja aplikasi Anda. Misalnya, Anda dapat mengonfigurasi peringatan email untuk tim Anda jika durasi pelacakan kode kustom tertentu melebihi ambang batas yang Anda tetapkan.

  • Lihat laporan mendetail tentang sesi pengguna tempat Anda dapat melihat pelacakan tertentu dalam konteks garis waktu dari pelacakan lain yang dikumpulkan selama sesi yang sama.